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Preface 


Welcome to the Rainbow Computer 


We congratulate you on the purchase of the Rainbow personal computing 
system. The Rainbow computer is today’s most versatile CP/M system. And 
it is the only industry standard computer built to DIGITAL’s quality specifi- 
cations and backed by DIGITAL’s commitment to service and support. The 
Rainbow computer is a sound investment in personal productivity that you'll 
enjoy using every day. 


To get you started, we have prepared a set of easy-to-use documentation. 
We welcome your comments, which you can record on the card in the back 
of each manual. Please Jet us hear from you. 


Remember that purchasing your first Rainbow computer is just the begin- 
ning of your relationship with Digital Equipment Corporation, the world’s 
leading manufacturer of minicomputers. Our dedication to quality manufac- 
turing, our extensive availability of spare parts and accessories, and our 
service organization of 16,000 representatives worldwide are your further 
assurance of total DIGITAL quality. With the Rainbow computer and our 
unique CP/M-86/80 operating system you have an investment that will grow 
in value as you use it now and in the future. 
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Starting and Stopping the 
Computer 


This guide assumes you are a first-time user of Digital Equipment Corpora- 
tion's Rainbow computer. The guide presents each procedure in a step-by- 
step manner. Therefore, it is important for you to follow each step in the 
sequence given. If you attempt to follow steps out of sequence, some proce- 
dures may be confusing to you. 


This guide is organized as follows: 


e Chapter 1: Starting and stopping the computer 
e Chapter 2: Copying diskettes 


© Chapter 3: Using the LEARN RAINBOW self-instruction course that 
teaches basic concepts about the Rainbow computer and the 
CP/M-86/80 operating system 


Starting and Stopping the Computer 


The following information is helpful for you to know in order to use the 
computer: 


© In this guide, in examples of dialog between you and the computer, 
what the computer displays on the screen is printed in black. The 
characters you type from the keyboard are printed in color. 


¢ You can type these characters in either lowercase or uppercase. Use 
the Shift or Lock key on the keyboard to produce uppercase charac- 
ters. These keys are shown in the illustration below. 


Shift Lock Shift 
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NOTE 

You cannot use the Lock key to type the charac- 
ters shown above the numbers or above other 
special characters on the keyboard. For example, 
if you want to type $, %, *, (, :, ", ?, you must 
use the Shift key. The Lock key only affects the 
alphabetic characters. When uppercase is set using 
the Lock key, you can resume lowercase by press- 
ing the Lock key again. 


© Be sure to type all spaces and punctuation marks exactly as they are 
printed in this guide. In many cases, if you mistype a word or charac- 
ter, for example, a semicolon (;) when it should be a colon (:), a 
message is displayed and you must retype the line. 

. means to press the Return key. 

. means to hold down the control key (labeled Ctrl on the 
keyboard). While you are still holding the Ctrl key, press the C key 
and then release both keys. 


(To see the location of these keys refer to the illustration below.) 


Control Shift Lock Return 
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NOTE 

You can’t hurt the computer. Nothing that you 
type on the keyboard will do any damage to the 
Rainbow computer. 


The illustration below shows a Rainbow computer including a monitor 
(video screen), keyboard, and system unit with two diskette drives. (Some 
units may have four diskette drives.) 


SYSTEM UNIT 


DRIVE 


MONITOR 


Starting and-Stopping the Computer 


Setting up the Rainbow Computer 


If you need help at any time, call the appropriate 
DIGITAL customer Help Line number listed at the 
end of this guide. 


The instructions in this section assume that the computer has been installed 
according to the Rainbow Installation Guide for instructions on choosing 
the language you want to use. 


Opening the drive doors on a horizontal unit 


1. Open drive A by pushing on the top of the drive door. 


PUSH TO OPEN 
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2. Open drive B by pushing on the bottom of the drive door. 


PUSH TO OPEN 


Starting and Stopping the Computer 


Opening the drive doors on a vertical unit 


1. Open drive A by pushing on the left edge of the drive door. 


PUSH TO OPEN 


Starting and Stopping the Computer 


2. Open drive B by pushing on the right edge of the drive door. 


PUSH TO OPEN 


Starting and Stopping the Computer 


Removing the protective card or diskette 


1. Be sure the diskette drives are empty. 


2. If the protective card was not removed as part of the installation 
procedure, remove it now from drive A (and drive C if you have four 
drives). Also remove any diskettes that you find in the drives. Remove 
these by grasping their outer edge and pulling gently. 


The protective card prevents the drive components from moving dur- 
ing shipment. Be sure to save it to use later if you move the computer. 


Starting and Stopping the Computer 


Turning on the Rainbow Computer 


Turn on the computer by pressing the power switch to the 1 (on) position. 


HORIZONTAL 
UNIT 


VERTICAL 
UNIT 


After a few seconds, you hear whirring sounds and a beep. Then the Main 
System Menu is displayed as shown on the next page. 
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iso) +] *] 3/4) 
Rainbow 100 
Eepyrignt te9 Dightel Equipnent Corporation 1983 


A= start from Drive 


stert from Drive 
Drive 
Drive 


cone 


Drive 
+ execute Seif Test 


4080 


+ enter Terminal Mode 


Helpful Information 
When you turn the computer on: 


e It automatically runs a short self-test to check its components. 
e The drive doors may be open or closed. 


© The version number of the computer is displayed above the copyright 
notice in the Main System Menu. The number on your screen may be 
different from the number shown in the sample above. If you ever 


need to report a problem, your vendor may ask for your version 
number. 


NOTE 

If you see a list of language options, refer to the 
Rainbow Installation Guide for instructions on 
choosing the language you want to use. 


VW 


Starting and Stopping the Computer 


e If the display of the Main System Menu is too dim or too bright, or is 
not displayed at all, adjust the brightness and contrast controls on the 
back of the monitor as shown below. 


ee 
/\s 


CONTRAST 
BRIGHTNESS CONTROL 
CONTROL 


Contrary to the instructions in the Main System Menu, do not press any 
keys at this time. Wait until you have followed the instructions for inserting 
a diskette. If you accidentally press A, for example, the computer displays: 


See Owner’s Manual - MESSAGE 21 - drive not ready 
If you see this message, turn the computer off by pressing the power 
switch to 0. Then turn it on and begin again. If you see any other message, 


follow the instructions given in the message. 
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Starting and Stopping the Computer 


Finding the CP/M-86/80 Master 
System Diskette 


1. Open the Rainbow CP/M-86/80 Operating System Kit and remove the 
diskette box. 


CP/M-86/80 
OPERATING SYSTEM 
KIT 
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Starting and Stopping the Computer 


2, Remove the CP/M-86/80 master system diskette from the diskette 
box. 


Ane CP 'M.86'80 V2.0 BIN RX50 
‘cornoco 


software 


— 


EN20080 
did 


sottware 
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Starting and Stopping the Computer 


3. Remove the CP/M-86/80 master system diskette from its protective 
paper envelope. 


WRITE- 
PROTECT 
TAB 


DISKETTE COVER 


DISKETTE 
DISKETTE 


SURFACE 
DO NOT 
TOUCH 


PROTECTIVE 
ENVELOPE 


Helpful Information 


¢ Handle a diskette by its edges. Do not touch diskette surfaces that 
show through in the center. 


e If you want more information diskettes, refer, at your leisure to 
Appendix A in the Rainbow CP/M-86/80 User's Guide. 
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Starting and Stopping the Computer 


Starting the Operating System 


The Rainbow computer operates with a group of instructions called an 
operating system that controls the overall operation of the computer. You 
are using an operating system known as CP/M-86/80. 


When the Main System Menu, shown in the section called ‘‘Turning on the 


Rainbow Computer,” is displayed on the screen, you can start the operat- 
ing system. Proceed with the instructions on the next page. 
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Inserting the master system diskette 
into a horizontal unit 


1. If the drive A door is closed, open it. 
2. With the diskette label facing up and the write-protect tab on the left, 
insert the diskette into drive A. 


ALIGN ORANGE ARROW 
ON DISKETTE WITH 

THE ORANGE STRIPE 

ON THE DISKETTE DRIVE 


3. With the diskette securely in drive A, close the drive door by pushing 
on the outside of the open door. If the door does not close easily, 
make sure the diskette is fully inserted. 


PUSH TO CLOSE 


V7 
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Inserting the master system diskette 
into a vertical unit 


1. If the drive A door is closed, open it. 
2. With the diskette label on the left and the write-protect tab facing 
down, insert a diskette into drive A. 


ALIGN ORANGE ARROW 
ON DISKETTE WITH 

THE ORANGE STRIPE 

ON THE DISKETTE DRIVE 


3. With the diskette securely in the drive, close the door by pushing on 
the outside of the open door, If the door does not close easily, make 
sure the diskette is fully inserted. 


PUSH TO CLOSE 
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Starting and Stopping the Computer 


On the keyboard, type: 
A 


in response to the Main System Menu. 


Helpful Information 


¢ Typing A tells the computer which drive contains the system diskette. 
e You will hear clicking and whirring sounds from the drive. 

© Small lights beside the drives light up briefly. 

© You will see the following message: 


CP/M-86/80 Loading ... 


e After the clicking and whirring sounds stop, the operating system dis- 
plays the start-up message as shown below. 


CP/M-86/80 Version 2.0 (1.19 
(c) Copyright 198) Digital Research Inc. 
(cd Copyright 1982,1983 Digital Equipment Corporatior 
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Starting and Stopping the Computer 


* The version number of the operating system is displayed. The number 
on your screen may be different from the number shown in the previ- 
ous screen. 

® If the entire start-up message is not displayed as shown, follow the 
instructions shown in the message at the top of the screen, 


Congratulations! You have now 
successfully started the operating 
system, 


The last symbol displayed on the left side of the screen, A>, is called the 
operating system prompt or prompt. The computer displays this prompt 
automatically to indicate that it is waiting (or prompting) for instructions 
from you. The prompt consists of the name of the drive the operating 
system is currently accessing and a right angle bracket (for example A>), 
The drive that is currently being accessed is also known as the active, or 
default, drive. 
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Messages 


While you are using the computer, you may see unexpected messages dis- 
played on the screen. There are many possible reasons for these messages. 
For example, the computer may have found a problem while you are run- 
ning a program, which is a collection of instructions to the computer. If you 
see a message in reverse video that begins with 


See Owner’s Manual - 


refer to the Rainbow Owner's Manual. For all other messages, refer to the 
Rainbow CP/M-86/80 User’s Guide. The illustration below shows an exam- 
ple of a message. You see this message if you have inserted a diskette in 
the wrong way. The Rainbow CP/M-86/80 User's Guide lists all operating 
system messages in alphabetical order and explains how to solve the prob- 
lem that causes each message. 
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Resetting the Rainbow Computer 
Resetting the computer is like turning it off and then on again without 
pressing the power switch. It allows you to begin again without having to 


remove the diskettes. When you reset the computer, it acts as though it 
were just turned on, and displays the Main System Menu. 


Helpful Information 
e You may need to begin again if the computer does not respond as 


expected; if, for example, the Main System Menu is not displayed after 
you turn the power on, 


© Resetting works only when the computer is turned on. 


How to reset the computer 
Practice resetting the computer now by following the instructions below: 
1. Press the Set-Up key shown in the illustration below. 


Set-Up 


Ld 


>I We i Ie Ie Is 


Ctrl 
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Then the text on your screen should look like the screen below. 


SET-UP 


TO EXIT PRESS "SET-UP" 
PRESS “HEL! 
TO RESET TYPE <¢CTRL/SET-UP> 


04.038 
yee 


TABS 


t 


1 T T T t T T t 
123456 7690 (REESE 234567090 REESE) 23456 7:0 EERE: 2356720 EEN 
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Starting and Stopping the Computer 


2. Hold down the Ctrl key. While you are still holding the Ctrl key, press 
the Set-Up key again. Then release both keys. 


Elsewhere in this guide, a reset is symbolized by Gerup) Cewiserup). 
You can reset the computer with or without diskettes inserted in the 
drives, 

The computer displays 


TESTING... 


After a few seconds, the computer again displays the Main System Menu. 
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Turning Off the Computer 


This section describes how to turn the computer off. However, if you are 
using the computer for the first time, leave it on with the master system 
diskette in drive A, and proceed to the section called What To Do Next. 


To end an operating session, remove all diskettes before turning the 
computer off. Then turn the computer off by pressing the power switch 
to 0. 


25 


Starting and Stopping the Computer 


IMPORTANT 

Do not remove a diskette from its drive while the 
operating system is accessing information on it. 
This activity is easy to detect because the small 
lights beside each drive are lit when the operating 
system writes to or reads from a diskette. The 
illustrations below and on the following page show 
the location of these lights, 


DRIVE LIGHT A 
DRIVE LIGHT B 
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DRIVE LIGHT A 
DRIVE LIGHT B 


IMPORTANT 

Always place diskettes in their protective paper 
envelopes and store them in a safe place. Keep 
diskettes in close-fitting, dust-tight boxes. Store 
these boxes in rooms with consistent temperature, 
humidity, and cleanliness. For a full description of 
the handling and care of diskettes, refer to Appen- 
dix A of the Rainbow CP/M-86/80 User's Guide. 


What To Do Next 
After you have typed A to start the CP/M-86/80 operating system, read 


Chapter 2 and follow the instructions to make a copy of the CP/M-86/80 
master system diskette that is currently inserted in drive A. 
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Copying a Diskette 


This chapter tells you how to format and copy a diskette. As an example, 
the chapter describes how to make a copy of the CP/M-86/80 master sys- 
tem diskette that is currently inserted in drive A. 


Why Copy a Diskette? 


It is important to copy or back up all diskettes because a diskette can be 
accidentally damaged or lost. By making copies of the diskettes, you gener- 
ate working copies and can store the originals, or master diskettes, The 
stored diskettes can then be used to make copies, if necessary. 


You should back up all your diskettes regularly. To do this, use the FOR- 
MAT and the DISKCOPY programs. The FORMAT program prepares a 
diskette so it is compatible with the CP/M-86/80 operating system on the 
Rainbow computer. The DISKCOPY program copies the entire contents of 
one diskette onto another. 
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Making a Working Copy of the 
Master System Diskette 


To copy the files from the CP/M-86/80 master system diskette in drive A, 
you must first insert a blank diskette into drive B. You will copy the 
CP/M- 86/80 master system diskette onto this blank diskette. 


Formatting a Blank Diskette 


Before you use a blank diskette, you must use the FORMAT program to 
prepare it. This ensures that the diskette is compatible with the 
CP/M- 86/80 operating system on the Rainbow computer. 


The FORMAT program takes less than two minutes to complete. 
NOTE 
If you make a mistake or want to stop the FOR- 
MAT program at any time, press the Exit key, 
located above the 9 key, to stop the program and 
return to the prompt, A>. Then begin again with 
step 4. 

To format the blank diskette, follow the steps below: 


1, Remove the blank diskette from its protective paper envelope. 
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WRITE-PROTECT 


NOTCH 
DISKETTE COVER DISKETTE 
SURFACE 
DISKETTE DO NOT 
TOUCH 
PROTECTIVE 
ENVELOPE 
MR:10899 


2. Open drive B and insert the blank diskette: 


Horizontal unit 


With the label facing down and the write-protect notch on the 
right, insert the diskette into drive B. (Be sure there is no tab 
covering the write-protect notch). 


INSERT DISKETTE 
“UPSIDE DOWN” 
IN DRIVE B 


WRITE- 
PROTECT 
NOTCH 


MR-10300 
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NOTE 
Your blank diskette may not have a label. 


© Vertical unit 


With the label on the right and the write-protect notch facing up, 
insert the diskette into drive B. 


MR-10889 


3. Close drive B by pushing on the outside of the open door. 
4. In response to the A> prompt, type: 


A>FORMAT (CRetum 


The program displays the first screen including a warning message as 
follows: 
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RAINBOW Diskette formatting program V1.4 


PRESS Exit TO QUIT 


CAUTION: FORMAT overwrites any existing information on the 
destination diskette. 


Selected drive: B 


Select drive for formatting (A, B, C, D, or «Return> for NO CHANGED 


Because you already have the diskette in drive B, press: 


Cisturn) 


5. FORMAT then reminds you to insert the diskette into the drive (if 
you have not done this already) and asks: 


Ready to format diskette in selected drive? (Y/N) 
Type: 
Y 

6. While formatting, the program displays the message: 


Formatting all tracks 
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Followed by: 


Verifying all tracks 
NOTE 
As the tracks are being formatted or verified, the 
drives make clicking and whirring sounds. Do not 
remove any diskettes while this is taking 
place, (A track is a concentric circle on a diskette 
where information is stored.) 
7. When the formatting process is complete, the program displays: 
Format/Verify complete to drive B 
Do you want to format another diskette? (Y/N) 
Because you are only formatting one blank diskette at this time, type: 
n 
8. Finally, FORMAT asks you to: 


Insert CP/M-86/80 SYSTEM DISKETTE then press Exit 


Because you already have the CP/M-86/80 master system diskette in 
drive A, press: 


fr zT) 
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The illustration below shows the location of the Exit key. 


Exit 


MR-10806 


NOTE 

If any messages are displayed while you are 
formatting the diskette, refer to the discussion of 
the FORMAT command or to the messages 
section in the Rainbow CP/M-86/80 User's Guide. 


Using the DISKCOPY Program 


Use the DISKCOPY program to copy all the files stored on the CP/M-86/80 
master system diskette in drive A to the formatted blank diskette in drive 


B. 
The DISKCOPY program takes less than two minutes to complete. 


NOTE 

If you make a mistake or want to stop the 
DISKCOPY program at any time, press the 
Exit key, located above the 9 key, to stop the 
program and return to the prompt, A>. 

Then begin again with step 1. 
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1. After the A>, type: 


A>DISKCOPY (Rew) 


The screen displays the text shown below. 


Rainbow 


DISKETTE COPY PROGRAM V1.4 


PRESS Exit TO QUIT 


Copy trom source diskette in drive A 
to destination disvette in drive B 


fire the drives correct? Cyn ll 


If you have inserted the diskettes, type: 


y 
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2, DISKCOPY then adds the instructions shown below. 


cr 


RAINBOW 


DISKETTE COPY PROGRAM Vt.4 


PRESS Fxst TO QUIT 


Copy form source diskette in drive & 
lo destination distette in drive B 


Insert source diskette into drive & 
Insert destination diskette into drive B 


Ready to atert capysng? even) Ml 


Because you already have the correct diskettes in drive A and drive B, 
you are ready to start copying. 


To start copying, type: 


Y 
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3. DISKCOPY then displays the text below as it reads and writes tracks 
on the diskette. 


RAINBOW 
DISKETTE COPY PROGRAM V1.4 
PRESS Exit TO GUIT 
Lopy from source diskette im drive & 
to destination distette io drive B 
Copying all tracks 
Reading tracts tt Writing track: tt 


The cursor (the blinking rectangle) moves between the Read Track 
and Write Track portions of the screen indicating which of the 80 
tracks (numbered 0-79) are currently being read or written. The 
current track being read from or written to is represented by tt in 
the screen above. 
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As the tracks are being read or written, the small lights beside each 
drive turn on and off, and the drives make clicking and whirring 
sounds. Do not remove any diskettes while this is taking place. 
When the copying process is complete, the program displays the text 
below. 


RAINBOW 


DISKETTE COPY PROGRAM V1.4 


PRESS Exit TO QuiT 
Copy Irom source diskette in drive & 


Copying all tracks 
Reading track: 79 Writing track: 79 
Copy/Verity complete to drive B 


iis. your we dQiite He itatber eaays) oronl 


4. Because you do not want another copy at this time, type: 


NOTE 

If any messages are displayed while you are 
copying, refer to the discussion of the DISKCOPY 
command in the Rainbow CP/M-86/80 User's 
Guide, or to the section of that guide on 
messages. 
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The program then displays the instructions shown below. 


RAINBOW 


DISKETTE COPY PROGRAM V1.4 


PRESS Exit TO QUIT 


Insert CP/M-06/80 SYSTEM DISKETTE then press the Exit bey. fl 


— ——————— ———— a 


Because the master system diskette is already inserted in drive A, 
press: 


ma 


Then, the operating system displays: 


A> 


Congratulations! You have now successfully 
created a copy of the CP/M-86/80 
master system diskette. 
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Removing and Storing the Master 
System Diskette 


To end this copying procedure: 


4; 


Open the drive A door and remove the CP/M-86/80 master sys- 
tem diskette. 


Return this diskette to its protective envelope and store it in a safe 
place. By storing this master diskette, you are preserving a reliable 
diskette from which to make future copies of the operating system if 
the diskette you use daily is damaged or lost. 


Open the drive B door and remove the newly copied diskette. 


NOTE 

Remember not to remove a diskette from its drive 
if the drive light is lit. This indicates that the 
computer is still accessing information. 


On a spare label, write “‘CP/M-86/80 Working”’ with a felt-tip pen. 


IMPORTANT 

If you have already attached the label to the disk- 
ette, do not write on the label with a ball-point 
pen or a pencil as these can damage the diskette. 


Attach the label to the front of the diskette. Use this ‘‘working’ copy 
for your everyday operations. 


Looking at the Diskette Directory 


Each diskette contains files, which are collections of information. Each disk- 
ette also contains a listing of all files, called a directory, similar to a book’s 
table of contents. A directory lists the files stored on the diskette. 


To display the names of files stored on the CP/M-86/80 working diskette: 


1, 


Insert the diskette with the working copy of the CP/M-86/80 operating 
system into drive A. 
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2. After the system prompt, type: 
AsDIR 


Remember that the symbol means ‘‘press the Return key.” 


The operating system displays a list of file names on the screen as 
shown below. Note that the DISKCOPY program (DISKCOPY.COM) 
and the FORMAT program (FORMAT.COM) are listed in the 


directory. 
ArDIR 
@:BACKUP CMD ; DATE CMD : DEMO poe : DISKcOPY com 
A:FORMAT COM : HELP CMD : MAINT CMD ; MORIVE CMD 
AiPIP CMD : PRACTICE TXT; RED CMD: STAT CMD 


A:SUBMIT CMD : SYSCOPY SUB 
SYSTEM FILESCS) EXIST 


all 


Helpful Information 


* The names on your screen should be the same, but they may appear 
in a different order. 


« The message SYSTEM FILECS) ExIST means that other files are also 
stored on the diskette, but are not included in the directory display. 
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Remember that nothing you type on the keyboard will damage the 
computer. 


You can type instructions to the operating system in lowercase or 
uppercase characters. To produce uppercase characters, use the Shift 
or Lock keys. 


If you make a typing mistake, you can correct it by using the delete 
character key (the key above the Return key, marked with an X) as 
long as you have not pressed the Return key. 


Delete 
Character 


MR-10753 
If you made a mistake but have already pressed the Return key, the 
operating system repeats what you typed followed by a question mark, 
For example, if you type: 
A>DIRR 


the operating system responds with: 


DIRR? 
A> 


As long as you see the prompt, A>, you can type instructions to the 
operating system. At this point, you can retype the correct command: 


A>DIR CRewm 
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What To Do Next 


Proceed with Chapter 3 and take the self-paced computer instruction course 
called LEARN RAINBOW. 
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Using the LEARN RAINBOW 
Course 


The Rainbow computer comes with a self-paced computer-based instruction 
course that teaches you about the Rainbow computer and the CP/M-86/80 
operating system. These instructions are stored on two separate diskettes 
labeled “LEARN RAINBOW.” If you plan to take the entire course at one 
time, allow one to three hours. The course design, however, allows you to 
take a break whenever you are ready and then return to the lesson you 
were studying. 


LEARN RAINBOW Course Format 


All of the instructions in the LEARN RAINBOW course are presented on 
the Rainbow computer. Animated graphics and text give you an overview 
of: 

© The major components of the Rainbow computer 
The CP/M-86/80 operating system 


* Fundamental commands 


Editing capabilities (creating and changing documents) 
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e Handling and maintaining diskettes 


Printing and copying documents 


NOTE 
The course does not replace documentation. 


Using the LEARN RAINBOW Course 


To start the course, your computer must be turned on. 


q. 


Find the two course diskettes from the diskette box in the Rainbow 
CP/M-86/80 Operating System Kit. “LEARN RAINBOW” is printed on 
the diskettes’ labels. To the right of “LEARN RAINBOW”, the first 
diskette is identified by BIN RX50-A as shown below; the second disk- 
ette is identified by BIN RX50-B. 


LEARN RAINBOW BIN Axs0-A 


[coe 


ZOPO080 


software 


Remove the course diskettes from their protective envelopes. 


3. Open the drive doors. If the CP/M-86/80 operating system diskette is 
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still in drive A, remove it and put it away in its protective envelope. 
Insert the first diskette (labeled RX50-A) into drive A, and the second 
diskette (labeled RX50-B) into drive B. Close the drive doors. 


Using the Learn Rainbow Course 


To start the course: 


© Doa reset by pressing the Set-Up key and then holding the Ctrl key 
and pressing the Set-Up key again. This procedure causes the Main 
System Menu to be displayed again. 


e From the Main System Menu, type: 
ry 


The operating system displays initial messages followed by the 
introductory message shown below. 


TOA008 


Educational Services 


WELCOME 
To 
LEARN 


RAINBOW 


+ Press Version 2.0 Copyright (c) 1983 Digital Equipment Corporation 
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Using the Learn Rainbow Course 


4, Now press: 


(exe) 


This key is shown in the illustration below. 


Do 


The course then displays its Main Menu listing the titles of the main 


sections of the course. 


rc 


MALN MENU 


LEARN RAINBOW 


Mate @ choice by using the 
up and down arrow beys 


Then press 


map OF THE COURSE 


MODULE 1 


moDULE 2 


MODULE 3 


MODULE 4 


LEAVE THE 


Getting Started 
Your Rainbow Computer 
Managing Files 
Options 


course 
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Helpful Information 


We recommend that you proceed through the entire course, after fin- 
ishing this chapter. 


e If you wish to take a short break, choose the “LEAVE THE 
COURSE” option from any module menu. 


* Take special care not to exit from the course too soon. As you finish 
each lesson, check it off in the list provided in the next section, “‘Mod- 
ule Descriptions.” That way, you can be sure to return to the appro- 
priate lesson after taking a break. 


e When you return from a break, type: 


A>LEARN Cham) 
The course displays the WELCOME TO LEARN RAINBOW message. 
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Menu and Module Descriptions 


The course is divided into an introduction and four sections called modules; 
each module consists of from three to six lessons. At the end of each 
module, the course provides a summary of what you have just learned. The 
introduction describes; 


© The features of the course, such as HELP 


© The organization of the course 


The course is structured around menus. These allow you to move through 
the course quickly and efficiently. There are five menus: 

e One Main Menu 

© Four Module Menus 


The Main Menu offers the following choices: 


® A course map that shows a diagram of the course structure 


* A list of modules that allows you to move to one of the four module 
menus or the introduction 


* A LEAVE THE COURSE option that takes you out of the course 
Each Module Menu offers the following choices: 


e Various lessons 
* A summary of all the lessons in the current module 


e A RETURN TO MAIN MENU option. This moves you back to the 
Main Menu from which you can look at the course map or proceed to 
another module. 


e A LEAVE THE COURSE option that takes you out of the course 


The checklist on the next page shows the lessons covered in each module. 
Check off each one as you complete it. 
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Using the Learn Rainbow Course 


Introduction 

Module 1: GETTING STARTED 

1.1 Computer Start-up 

1.2 Backing Up Diskettes 

1.3 Using Application Programs 

(Choose “RETURN TO MAIN MENU" to go to another module) 
Module 2; YOUR RAINBOW COMPUTER 

2.1 Computer Overview 

2.2 Hardware Components 

2.3 The Keyboard 

2.4 The CP/M Operating System 

(Choose “RETURN TO MAIN MENU” to go to another module) 
Module 3: MANAGING FILES 

3.1 Introduction to Files 

3.2 Naming Files 

3.3 Maintaining Files, Part 1 

3.4 Maintaining Files, Part 2 

3.5 Printing and Copying Files 

3.6 Creating and Editing Files 

(Choose “RETURN TO MAIN MENU” to go to another module) 
Module 4: OPTIONS 

4,1 Extended Memory 

4.2 Printers 

4,3 Extended Graphics 

4.4 Communications Software 

4.5 The Hard Disk Drive 

4.6 Hard Disk Drive Utilities 

(Choose “RETURN TO MAIN MENU" to go to another module) 


51 


Using the Learn Rainbow Course 


Getting Help 


To get help at any time while you are taking the course, press the Help 
key. This key is located to the left of the Do key in the top row of keys. If 
you press the Help key while taking a lesson, the course displays a menu 
across the bottom of the screen. The screen below shows HELP instruc- 
tions and the HELP Menu on the bottom of the screen. 


Good! WELP OPTIONS: 


After you press the Help tey, the Continue 
Strip appears at the bottom of the screen 
Notice that the first choice on the strip Advice 


ty highlighted in reverse video 


Backup 
You highlight the choice you want by using 

the left and right arrow keys or by typing Forward 
enough Letters of the option to identify 

it, After you choose an option, you press Glossary 


Exit 


© Try highlighting different options, then choose ADVICE 


chooses QMUMNEMNY novice wackur Fomwaep ciossary exit 


NOTE 

The term “reverse video”, used in the screen 
above, means that a word is displayed in light 
characters on a dark background. 


When the HELP Menu is displayed: 


1. Choose one of the HELP options by pressing the left or right arrow 
keys or by typing the first letter of the option, for example, C for 
Continue. 


2. Press the Do key. 
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Using the Learn Rainbow Course 


The following is a brief description of each option in the HELP Menu. 


Option 


Continue 
Advice 
Backup 


Forward 


Glossary 


Exit 


Description 


Returns to the screen you were reading. 
Displays suggestions to help you respond to a screen. 


Returns to the first display on the current topic discus- 
sion in a lesson 


Moves forward to the first display on the next topic in 
a lesson 


Allows you to request the definition of a word used in 
the course. After you type the word, press the Do key. 
The course displays the definition if it is contained in 
the course glossary. 


Returns to the menu of the current module. 


To leave HELP, select either the Continue or the Exit option as described 


above. 
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Leaving the LEARN RAINBOW 
Course 


To leave the course, select the LEAVE THE COURSE option from the 
Main Menu or any of the module menus. (If you are in the middle of a 
lesson, you can use the Exit option on the HELP strip to get to the module 
menu.) When you leave the course, the operating system displays the 
screen below. 


You are now leaving 
Learn Rainbow 


To move on to another task 


1, Remove the diskettes from 
Drive @ and Drive B. 


1. Remove the “Learn Rainbow’ 
diskettes from both drives 
and store them safely, 


' ' ' 
' 1 1 

' ' ' 
2. Replace the diskettes in 1 1 1 
their protective covers. 1 1 2. Reset the computer by 1 

1 ' pressing Set-Up, then ' 

3, Turn off the power by ' ' Ctrl/Set-Up. 1 
pressing the power switch 1 1 ' 
to the “0” position. 1 1 3. From this point, proceed 1 
' 1 1 

' 1 


as if you hed just turned 


the computer on. 
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What To Do Next 


At this point, you are ready to begin working with the computer. You may 
wish to do one of the following: 


Review a specific topic in the LEARN RAINBOW course. 


Read an application manual such as SELECT-86 or Multiplan-86 for 
information about: 


~— Making a copy of the application diskette or the LEARN 
RAINBOW diskettes. To copy the LEARN RAINBOW diskettes, 
follow the same procedures for copying an application diskette. 


— Creating and editing a document using a wordprocessing program. 
— Running the application program. 


— Making a single diskette (a system/application diskette) with both 
the system programs and the application programs on it. 


Read the Rainbow CP/M-86/80 User's Guide for information about the 
CP/M-86/80 programs and commands, 


If you are not going to continue to use the computer at this time, open the 
drive doors and remove the diskettes. Remember to return the diskettes to 
their protective paper envelopes. Turn the computer off by pressing the 
switch to 0. 
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Hard Disk Uses 


What is the Hard Disk 


The hard disk (called a Winchester disk) can be added onto the Rainbow 
computer. This disk enables you to store large files or many small files, and 
access the files very rapidly. 


The hard disk’s storage capacity is defined in megabytes. A byte is equal to 
one character, and a megabyte is equal to a million characters. The hard 
disk contains ten megabytes of storage space, which is equivalent to 25 
times the storage capacity of a single diskette. 


In terms of type-written pages, a diskette stores about 150 pages of text; 
the 10-megabyte hard disk stores about 3750 pages; the 5-megabyte hard 
disk stores about 1875 pages. 


The disk can simulate up to four diskette drives, each with a much larger 
capacity than a single diskette. 
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Hard Disk Uses 


Because of its speed and large working capacity, you may want to use the 
hard disk to store the programs and files you use daily, and use diskettes 
for storing less-used files. If you are using an application program, we 
recommend that you store it on the hard disk and store data files on 
diskettes. 


The figure below shows where the hard disk fits into the Rainbow 
computer. 


MONITOR 


KEYBOARD 


For a description of installation procedures, refer to the Rainbow 
Winchester Disk Option Installation Guide. 
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Uses of the Hard Disk 
You can use the hard disk to: 


© Store application programs or data files. 


© Store the operating system. By storing the operating system on the 
hard disk, you need not insert the operating system diskette every 
time you want to start the operating system. 


© Automatically start your operating system from the hard disk by sim- 
ply turning on the power switch. 


For detailed instructions on how to accomplish the above tasks and for 
more information on the hard disk, refer to your Rainbow CP/M-86/80 
User's Guide. 


59 


“6 


Appendix 


©) 


© 


Help Line Phone Numbers 


Country 


U.S.A. 

Canada 

United Kingdom 
Belgium 

West Germany 
Italy 

Japan 
Denmark 
Spain 

Finland 
Holland 
Switzerland 
Sweden 
Norway 
France 

Austria 


Australia Sydney 
All other areas 


A 


Getting Help | 


Phone Number 


(800) DEC-8000 

(800) 267-5251 

(0256) 59 200 

(02)-24 26 790 

(089) 95 91 66 44 

(02)-617 53 81 or 617 53 82 
(0424) 64-3302 

(04)-30 10 05 

(1)-73 34 307 

(90)-42 33 32 

(1820)-31 100 f 
(01)-810 51 21 

(08)-98 88 35 

(02)-25 64 22 

(1)-687 31 52 

(222)-67 76 41 extension 444 


(02) 412-5555 
(008) 226377 


63 


A 
Advice Help option 53 


Backup Help option 53 
Blank diskette 30, 35 
Brightness control 12 
Byte 57 


Cc 


Characters 
color 2 
lowercase 2 
uppercase 2 
Closing drive A 17-18 
Closing drive B 32 
Command 
DIR 42 
DISKCOPY 36 
LEARN 49 


Computer 
Rainbow 4 
Continue Help option 53 
Contrast control 12 
Control knob 
brightness 12 
contrast 12 


Index 


Copying the master system diskette 29, 


35 
Correcting mistakes 43 
Course 
LEARN RAINBOW 45 
Ctrl key 3, 24 
Cursor 38 


D 


Default drive 20 
Delete character key 43 
DIR command 42 
Disk 
hard 57 
DISKCOPY command 36 
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Index 


DISKCOPY program 29-30, 35, 42 
DISKCOPY screen 36 
Diskette 
blank 30, 35 
box 13 
CP/M-86/80 master system 30 
directory 41 
drives 4 
formatting 35 
inserting master system 17-18 
labeling 41 
master system 13, 15 
working 41 
Diskette label 17-18, 32 
Diskettes 
handling 15, 27 
inserting 31-32 
LEARN RAINBOW course 46 
making back-up 29 
master 29 
removing 9, 25, 39, 41, 55 
removing course 46 
storing 27, 41 
Displaying file names 42 
Displaying Main System Menu 22 
Do key 48, 52 
Drive 
default 20 
diskette 4 
lights 26, 39, 41 
Drive A 
closing 17-18 
opening 5, 7, 41 
Drive B 
closing 32 
opening 6, 8, 31, 41 


E 


Ending an operating session 25 
Exit Help option 53 
Exit key 35 
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F 


Files 41 
CP/M-86/80 operating system 35 
displaying names 42 

FORMAT program 35 

Formatting a diskette 35 

Forward Help option 53 


G 
Glossary Help option 53 


H 


Handling diskettes 15, 27 
Hard disk 
(Winchester disk) 57 
installation 58 
storage capacity 57 
uses 59 
Help 
LEARN RAINBOW course 52 
Help line phone numbers 63 


| 
Inserting a diskette 31-32 


K 


Key 
Ctrl 3, 24 
delete character 43 
Do 48, 52 
Exit 35 
Help 52 
Lock 2-3, 43 
Return 3, 42-43 
Set-Up 22, 24 
Shift 2-3, 43 
Keyboard 2, 4 


Index 


ana 


L 


Labeling diskettes 41 
LEARN command 49 
LEARN RAINBOW course 45 
checklist 51 
diskettes 46 
format 45 
Help 52-53 
introductory message 47, 49 
leaving 54 
lessons 50 
Main Menu 48, 50 
map 50 
Module 1 51 
Module 2 51 
Module 3 51 
Module 4 51 
Module Menus 50 
modules 50 
starting 46-47 
LEARN RAINBOW Help option 
Advice 53 
Backup 53 
Continue 53 
Exit 53-54 
Forward 53 
Glossary 53 
Leaving LEARN RAINBOW course 54 
Leaving LEARN RAINBOW Help 53 
Lock key 2-3, 43 


M 


Main System Menu 10-11, 24 
Making back-up diskettes 29 
Master diskette 29 
Master system diskette 13, 15, 30 
copying 29, 35 
inserting 17-18 
Megabyte 57 


Messages 12, 21, 39 
operating system 21 
Monitor (video screen) 4, 12 


° 


Opening drive A 5, 7, 41 
Opening drive B 6, 8, 31, 41 
Operating session 
ending 25 
Operating system 
files 35 
kit 13, 46 
prompt 20, 40, 43 
start-up message 19 
starting 16 


P 


Power switch 10, 22, 25, 55 
Program 21 

DISKCOPY 29-30, 35, 42 
Protective card 

removing 9 
Protective paper envelope 15, 27, 46 


R 


Rainbow computer 4 

installing 5 

instructions 16 

resetting 22 

setting up 5 

turning off 25 

turning on 10 

version number 11 
Removing diskettes 9, 25, 39, 41, 55 
Removing protective card 9 
Removing the course diskettes 46 
Resetting the Rainbow computer 22 
Return key 3, 42-43 
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Index 


Ss Vv 
Self-test 11 Video screen (monitor) 4, 12 
SET-UP 

CTRL/SET-UP 24 w 
Set-Up key 22, 24 
Set-Up screen 23 Winchester disk 57 
Setting up the Rainbow computer 5 Working diskette 41 
Shift key 2-3, 43 Write-protect notch 32 
Start-up message 19-20 Write-protect tab 17 
Starting the LEARN RAINBOW course 

46-47 


Starting the operating system 16 
Storing diskettes 27, 41 
System unit 4 


T 


Tracks 38 
Turning off the Rainbow computer 25 
Turning on the Rainbow computer 10 
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Preface 


Welcome to the Rainbow Computer 


We congratulate you on the purchase of the Rainbow personal computing 
system, The Rainbow computer is today’s most versatile CP/M system. And 
it is the only industry standard computer built to DIGITALs quality specifi- 
cations and backed by DIGITALs commitment to service and support, The 
Rainbow computer is a sound investment in personal productivity that you'll 
enjoy using every day. 


To get started, we have prepared a set of easy-to-use documentation. In 
the back of these volumes is a card to encourage your comments. Please let 
us hear from you. 


Remember that purchasing your first Rainbow computer is just the begin- 
ning of your relationship with Digital Equipment Corporation, the world’s 
leading manufacturer of minicomputers. Our dedication to quality manufac- 
turing, our extensive availability of spares and accessories, and our service 
organization of 16,000 representatives worldwide are your further assur- 
ance of total DIGITAL quality. With the Rainbow computer and our unique 
CP/M-86/80 operating system you have an investment that will grow in 
value as you use it now and in the future. 


Preface 


Intended Reader 


This guide is intended for first-time users of Digital Equipment Corpora- 
tion’s Rainbow computer. The purpose of this guide is to provide you with 
detailed information on how the Rainbow computer operates. 


The Rainbow computer runs the CP/M-86/80 operating system, an operat- 
ing system developed especially for it. Although other operating systems 
can be run on the Rainbow computer, the CP/M-86/80 operating system is 
used in the examples in this guide. 


This guide assumes that you have: 
® Installed the Rainbow computer according to the instructions in the 


Rainbow Installation Guide. 
© Read the Rainbow CP/M-86/80 Getting Started, which includes: 


— Starting and stopping the computer 
— Making a copy of the CP/M-86/80 master system diskette 


— Taking the self-paced Rainbow computer instruction course 
(LEARN RAINBOW) 


Preface 


Guide Organization 


Chapter 1 introduces the CP/M-86/80 operating system and includes 
an example of how to create and print a short document. 

Chapter 2 discusses the CP/M-86/80 operating system commands in 
alphabetical order. 

Chapter 3 describes how to create and edit documents using the 
CP/M-86/80 editor called RED. 

Chapter 4 discusses how to create a system/application diskette. 

Chapter 5 discusses the basic procedure for copying files to and 
from the hard disks. 

Chapter 6 discusses advanced hard disk procedures. 

Appendix A describes how to store, handle, and use diskettes. 

Appendix B lists the operating system messages, what they mean, and 


what to do about them. 
Appendix C lists the DIGITAL Customer Help Line phone numbers. 


Conventions Used 
Follow the conventions listed below while using this guide. 


e Jn examples of dialog between you and the computer, what the com- 
puter displays on the screen is shown in black. The characters you 
type from the keyboard are shown in color 


* You can type these characters in either lowercase or uppercase char- 
acters. Use the Shift or Lock key (see Figure 1) on the keyboard to 
enable uppercase characters. 


IMPORTANT 

The Lock key does not enable you to type the 
numeric and special symbol keys, For example, if 
you want to type $, %, *, (, :, ? you must use the 
Shift key. The Lock key only affects the alphabet- 
ic characters. 


xi 


Preface 


© Make sure to type all spaces and punctuation marks exactly as they 
are printed. 

# When you see Cfeum), press the Return key on the keyboard (see 
Figure 1). 


e When you see , hold down the control key (Ctrl key on the 
keyboard as shown in Figure 1), While you are still holding the Ctrl 
key, press the C key and then release both keys. 


Control 


Shift 
Lock Return 


Figure 1. Control, Shift, Lock, and Return Keys 


Information for Advanced 
CP/M-86/80 Users 
Advanced users of the CP/M-86/80 operating system can find the Rainbow 


CP/M-86/80 Technical Documentation Kit useful (order number QV070-GZ). 
You can also order the information in this kit separately as follows: 


1. CP/M-86/80 information and the industrial standard specifications for 
the Rainbow computer (order number QV067-GZ) 


2. Information on DIGITAL's family of printers for the Rainbow com- 
puter (order number QV069-GZ) 


Turn to the end of this guide for ordering information. 


xil 
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Introducing CP/M-86/80 


An operating system is a group of instructions that manages the overall 
operation of the computer, and the way you interact with the computer. 
One of the operating systems used on the Rainbow computer is called 
CP/M-86/80. 


With this operating system, you can run a variety of programs to help you 
write memos and reports, do financial analyses, and many other functions 
easily and efficiently. These programs include SELECT-86, Multiplan-86, or 
MBASIC-86. 


Hands On Experience 


This chapter explains introductory operating system concepts and opera- 
tions that allow you to: 


1, Start the operating system 


2. Use a few common commands (instructions to the operating system) 
and keys 


3. Create a short memo 
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Make changes to the memo 

Print the memo on a printer 

Make a copy of the memo on another diskette 
Look at, rename, or erase the memo 

Get help 


8 A Sh Pe 


The end of this chapter includes information on correcting problems. 


Starting the Operating System 


Start the CP/M-86/80 operating system by completing the following 
instructions: 


1. Be sure there is no protective card or diskette in any of the drives. 


2, Turn on the computer by pressing the power switch to the 1 (on) 
position on the front of the system unit. The drive doors can be open 
or closed. 


3. Be sure the Main System Menu is displayed on the screen, as shown 
in Screen 1. 
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Rainbow 100 


Version 04.068 
Copyright (cd Digital Equipment Corporation 1983 
All Rights Reserved 
Press A, B, C, D, W, S or T 
A+ start from Drive 4 


Be from Drive B 
Ce from Drive C 
De from Drive D 
Ws start from Drive W 
S + execute Self Test 

T + enter Terminal Mode 
1 


Screen 1. Rainbow Main System Menu 


IMPORTANT 

Do not press any keys until the Main System 
Menu is displayed. If you accidentally press a key 
and the Main System Menu is not displayed, reset 
the computer by pressing the Set-Up key, and 
then the Ctrl/Set-Up keys. 


. Remove the CP/M-86/80 working diskette from its protective paper 
envelope. (You created this diskette in the Rainbow CP/M-86/80 
Getting Started.) 


Open the drive A door and insert the working diskette. Be sure to 
align the orange arrow on the diskette with the orange stripe on the 
diskette drive. 


Close the drive door. 
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7. Start the CP/M-86/80 operating system by typing: 


in response to the Main System Menu. Typing A tells the computer 
which drive contains the operating system diskette. 


After you hear clicking and whirring sounds, the CP/M-86/80 operating ~ 
system displays: 


CP/M-86/80 Loading... 


followed by the start-up message shown in Screen 2. 


r 


CP/M-86/80 Version 2.0001, 19 
(ec) Copyright 1981 Digital Research Inc. 
cd Copyright 1982,1983 Digital Equipment Corporation 


aol 


Screen 2. CP/M-86/80 Start-up Message 
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NOTE 

The screens in this guide may not be identical to 
those displayed on your computer. The general 
information should be the same, but specific infor- 
mation, such as dates, times, and Version numbers 
may differ. If at any time, a screen does not dis- 
play at all, refer to the messages in Appendix B of 
this guide for help. 


The last symbol displayed on the left side of the screen, A>, is called the 
operating system prompt, or prompt. It indicates that the operating system 
is waiting (or prompting) for instructions. The prompt consists of the drive 
the operating system is currently working from and a right angle bracket 
(for example, A>). This drive is known as the active drive, or default drive. 


Using Commands and Keys 


Whenever the prompt is displayed, you can type a command. Commands 
are instructions that you type from the keyboard. These instructions tell 
the operating system what to do. 


Most of the operating system commands are designed to act on a file, 
which is a collection of information stored on the diskette. The CP/M-86/80 
operating system deals with two types of files: 


* Program files, which contain a collection of instructions telling the 
computer how to perform a specific task. 

® Text files, which contain a collection of user information, such as.a list 
of numbers or a memo. 


The operating system accepts commands from you to: 


e List the names of files stored on a diskette 

© Copy the entire contents of a diskette to another diskette 
© Copy individual files 

® Create text files 

* Display a text file on the screen 
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* Print files on a printer 
© Delete files 
© Run programs 
You type a command directly after the prompt, A>. As you type a com- 


mand, the computer displays the characters on the screen to the left of the « 
cursor, which is shown in Screen 3. 


(— at 
CP/M-86/80 Version 2.00€1.1) 

(c) Copyright 1981 Digital Research Inc. 

(c) Copyright 1982,1983 Digital Equipment Corporation 


all 


cursor 


Screen 3. Rainbow Cursor 


The cursor is a blinking rectangle (or a blinking underline if you change it 
using Set-Up) that indicates where the next character you type is displayed. 
The cursor moves to the right each time you type a character. 
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NOTE 

The computer displays the characters you type as 
lowercase characters unless you use the Shift or 
Lock keys to obtain uppercase characters, The 
Lock key affects only alphabetic characters. It 
does not allow such characters as ;, (, ?. (To pro- 
duce these characters, press the Shift key.) How- 
ever, you can change this feature using the Set-Up 
key. Refer to the Rainbow Owner's Manual to 
learn how to change features in Set-Up, A light 
above the Help and Do keys indicates when the 
Lock key is on. To release the Lock key, press 
the key again. 


You can type commands in either uppercase or lowercase characters. After 
typing most commands, press the Return key. Pressing the Return key tells 
the operating system that you have finished typing the command and want 
the command executed. Some programs display messages such as <CR> 
(for carriage return) or “RETURN” to indicate that you should press the 
Return key. 


Listing the Names of Files 


One common command is the DIR command, which displays the list of file 
names that are stored on a diskette. The list of file names is called the 
diskette’s file directory. Each diskette that contains files also contains a file 
directory, or directory, which is similar to a book’s table of contents. 


To list the files already stored on the working diskette in drive A, after the 
prompt, type: 


A>DIR Cieum) 


Type only what is printed in color. Remember that the symbol 
means "press the Return key”. 
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The operating system displays a list of file names. Screen 4 shows the 
entire dialog. 


ADDIR 
ArBACKUP CMD : DEMO DOC : DISKCOPY COM 
A:FORMAT CMD ; MAINT CMD : MDRIVE cmD 

A:PIP TxT : RED CMD : STAT comp 
A:SUBMIT CMD : SYSCOPY SUB A 

SYSTEM FILESC(S) EXIST 

al file name file type 


Screen 4, DIR Command for Drive A 


NOTE 

Complete file names consist of two parts: a file 
name and a file type. In the directory, the file 
name and file type are separated by a space. The 
file type indicates the type of file. For example, 
the file type DOC indicates a document or text 
file. The file names on each line in the directory 
are separated from each other by a colon (:). 
Refer to Chapter 2 for more information on file 
names. 


The operating system displays the message SYSTEM FILE(S) EXIST 
to remind you that other files are stored on the diskette in the system 
directory. Chapter 2 describes the system directory, 
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Mistyping and Correcting a Command 


The operating system executes commands after you press the Return key. 
If you misspell a command and then press the Return key, the operating 
system indicates it does not understand the command by redisplaying the 
incorrect command followed by a question mark (?). Try the following 
example. Remember, in the examples in this guide, you should only type 
the characters that are printed in color, What the computer displays is 
printed in black. 


Type: 
A>DIRR Game) 
The operating system displays: 


DIRR? 
A> 
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The prompt is displayed to show that the operating system is waiting for 
you to retype the command correctly (see Screen 5). 


ee 
CP /M-86/80 Version 2,00€1.1) 

(ce) Copyright 1981 Digital Research Inc. 

(c) Copyright 1982, 1983 Digital Equipment Corporation 


AsDIRR 
DIRR? 


on 


Screen 5. Misspelling a Command 


If you mistype a command and realize you have made a mistake before you 
press the Return key, there are several ways to correct it. Figure 2 shows 
one of the keys that you can use to correct typing errors. 
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Delete 
Character Key 


Figure 2. Delete Character Key 


Delete Character Key. Each time you press the delete character key, 

shown in Figure 2, the last character you typed is erased from the screen 

and the cursor is moved back one space. (You cannot erase the prompt.) 
1. To see how the delete character key works, type: 


A> RATNBWO 


2. Press the delete character key twice. The characters “O” and “‘W” 
disappear leaving the characters RAINB displayed on the screen, 


VW 
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3. Now type: 
ow 


to complete the word ‘‘RAINBOW”, 


The operating system displays RAINBOW on the screen, Screen 6 shows 
this sequence. : 


a >) 
ADRATNBHO 
Jka we 
a 
ADRAINB 
a 
~~ aN 
A>RALNBOW 


Screen 6. Using the Delete Character Key 


4. Press the delete character key seven times to erase the entire word. 
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Creating and Printing a Memo 
The following example shows you how to use the program called RED to 


create a memo and store it on the diskette. The example also shows you 
how to print the memo on a printer. 


Starting the Editor 


An editor is a program that allows you to create and change any text file. 
The editor you use with the CP/M-86/80 operating system is called RED. 


The first step in creating a file is to name it. Then type the text. 
1. To start RED and name the file, type: 

A>RED MEMO. TXT Chew) 
NOTE 
The file name can be no longer than eight 
characters. The file type can be no longer than 
three characters. You can use both alphabetic and 
numeric characters. 

RED responds with: 


Loading RAINBOW EDITOR Version 1.1 


to show that the editor is creating the file name. 
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After the file name is created, RED displays, at the top of the screen, 
a one-line list of commands you can use with the editor. On a second 
line, RED displays the name of the drive the file will be stored on, 
followed by the file name. (See screen 7). 


Va 
DRED: Insert Erase Pointer Goto Locate Replace Display Guit Next 
Document: A:MEMO.TXT Char: 1 Line: 1 
[ee e 
i] 


Screen 7. Creating a File Name Using RED 
2. To insert text in the memo, use the first command listed in the top 
line (Insert), Type: 


NOTE 
When using a RED command, type only the first 
letter of the command. 


The top line of the screen changes and RED instructs you to enter the 
text and press the Do key when finished. (See Screen 8). 
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>DINSERT: Enter text, then <DO> 
Document: A:MEMO. TXT Char: 1 Line: 1 


Screen 8. The Insert Command 


For this example, enter the following text shown in color. Be sure to press 
the Return and Do keys where indicated. 


TO: All Company Employees (Rewm) 

FROM: A. Marshall, Manager CRewm) 

SUBJECT: Extra Desk Keys Roum) CRewm) (Roum) 

All desks now have spare keys. If you have lost your key (Reum) 
or would like an extra one, please report to the guard’s (Roum) 
office in the front lobby. CRewn) CRewm) 

Thank you awa) Ce) 
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Pressing the Do key tells RED that you have finished entering text for this 
file. The top line of the screen returns to the original line and the cursor is 
displayed below the last line of text that you entered. (See Screen 9), 


DRED: Insert Erase Pointer Goto Locate Replace Display Quit Next 
MEMO. TXT ch 1 Line: " 


: A, Marshall, Manager< 
SUBJECT: Extra Desk Keys« 
« 


« 
all desks now have spare keys. If you have lost your tey« 
or would like an extra one, please report to the guard’s< 
office in the front lobby.< 

« 

Thank youc 


Screen 9. A Memo Created Using RED 


If you make a typing mistake while inserting text, before pressing the 
Return key, press the delete character key. Each time you press the delete 
character key, RED erases the last character you typed. 


Leaving the Editor 


To leave RED and return to the operating system prompt, use the Quit 
command. Type: 


a 
RED responds with three choices as shown in Screen 10, 
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QUIT: Keep Abandon <DO> 
Document: A:MEMO. TXT 


keep - this will save any changes made 
since the lest editing session 


Abandon - this will end editing WITHOUT 
saving the changes made. 


<Da> = go beck to the document 


Screen 10. The Quit Command 


To store the file on the diskette, type: 


RED responds with: 


Keeping 
A:MEMO. TXT 
please stand by... 
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Printing the Memo 


You can use the PIP (Peripheral Interchange Program) command to copy 
files to other devices, such as a printer or another diskette. If you have a 
printer, make sure it is connected according to the instructions in the 
printer manual. If you do not have a printer, skip to the next section. 


NOTE 
PIP also has other uses. See Chapter 2 if you 
want more information about PIP, 


To make a printed copy of the file, the general format of the PIP command 
is: 


PIP destination:=(drv:|file name 
In this case, 


© The drive (drv:) is drive A 
* The destination is LST:, which is the name for the printer 
« The file name is MEMO.TXT 


If you do not specify a drive with the file name, the operating system 
assumes the active drive: in this case, drive A. 


To print the memo, type: 
ASPIP LST:=MEMO. TXT Grown) 
If any message is displayed, make sure the printer is connected properly. If 


the message persists, refer to Appendix B of this guide for an explanation 
of the message and how to solve it. 
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Making a Copy of the Memo on 
Another Diskette 


You can also use the PIP command to copy files from one diskette to 
another diskette. This is useful if you want to make a back-up copy of a 
file, To make a copy of the memo on another diskette: 


1. Insert a blank diskette into drive B. Be sure to insert the diskette with 
the orange arrow on the diskette aligned with the orange stripe on the 
drive. 


2. Next to the prompt, type: 
A>PIP B:=MEMO, TXT Cham) 
This command line instructs the operating system to copy the file 
MEMO.TXT (assumed to be on drive A) onto the diskette in drive B. While 
the operating system is making the copy, you hear clicking sounds. When 


the sounds stop, Look at the directory of drive B to see if the copy was 
made. Type: 


A>DIR B: CRewm 
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Remember that you must type a colon when you specify another drive. 
Screen 11 shows the entire dialog. 


ADPIP Br-MEMO, TXT 


ApDIR B: 
Bs MEMO, TXT 
all 


Screen 11. Copying a File onto Drive B 


Performing Maintenance Tasks 

on Files 

The MAINT command runs the file maintenance program, which lets you 
perform the routine “housekeeping” tasks associated with using diskettes, 
such as viewing, renaming or erasing a file. The following examples show 
you how to use MAINT. 


First, display the file names stored on the system diskette in drive A. Type: 


AsMAINT CRewm ) 
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MAINT replaces the text on the screen with a detailed directory of the 
diskette (see Screen 12). 


ASMBE CMD RW Dir 26 HELP CMD RW Dir 8 RED DVL RW Dir 22 
DEMO DOC RW Dir 2 MAINT CMD RW Die 28 STAT CMD RW Dir 10 
DUMP COM RW Dir 2 PIP CMD RW Dir 8 SYSCOPY SUB RW Dir 2 


Screen 12. MAINT Command 


The directory consists of the name, type, attribute, and size of each file. 


NOTE 

The yalues shown in the screens in this guide, 
such as the file size, displayed under the kilobyte 
heading (KBs), may not be the same as those on 
your screen. Refer to Chapter 2 for a detailed 
explanation of the information shown in Screen 
12. 


2) 
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Using MAINT’s special function keys shown in Figure 3, you can: 


* Move the cursor 

© View the contents of a specific file 
° Rename a file 

¢ Erase a file 

* Cancel a command 

« Return to the operating system 


Addtni 
Cancel Exit Options Help Do Remove 


Tab Return Find / Prev Next Screen 
Screen Directional 
Select Arrow Keys 


Figure 3. MAINT Keys 
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Moving the Cursor 
Move the cursor by using the following keys; 


e The directional arrow keys move the cursor character-by-character in 
the direction of the arrows, 


@ The Tab key moves the cursor horizontally to the first character of 
the next file name. 


« The Return key moves the cursor to the first character of the file 
entry below the current file entry. 


¢ The Select key moves the cursor horizontally to the first character of 
the previous column. 


¢ The Find key moves the cursor to the first character of the first file 
entry at the upper left corner of the screen. 


Viewing a File 


To view the contents of MEMO.TXT, move the cursor to the first letter in 
WL the file name, Then press: 
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MAINT replaces the directory display on the screen with the contents of 
MEMO.TXT (see Screen 13). 


[rite specs ticotions eros) Muse) 
sis Ni ompany Eaployens 
hans A. Recanel iy Ranager 
SUBJECT! Extra Desh Keys 


All desis now have spare teys. If you have lost your key 
or would lite an extra one, please report to the guard’s 
office in the front lobby. 


Thank you 


Screen 13. Displaying Contents of a File 


To return to the MAINT directory, press: 
(Emi) 


located on the top row of keys above the 9 key. 


Renaming a File 
To rename a file, type the new name directly over the old name, To 


rename MEMO.TXT to FILE.TXT, move the cursor to the first letter in 
the file name MEMO.TXT. 
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Then type: 

FILE 

Notice that when you type the first character of the new file name (F in 
this case), MAINT displays the file entry in boldface characters. The bold- 


face characters serve as a reminder that you have “marked” the file for a 
name change. MAINT does not rename the file until you press the Do key. 


Now press: 
When you press the Do key, MAINT momentarily erases the screen, then 


displays the new directory (see Screen 14). Notice that, MEMO.TXT is no 
longer in the directory, but FILE.TXT is (listed alphabetically). 


ASN Gum Ra Sys FILE THT Rw Dir 2 PRACTICE TAT RW Dir 2 
jones GHDIp Sos 28 EORNOT! (GOH RW DP 9. SED EMR DLe 
Baccye END Ra Dir 30° «GEREN CHD RN Syn 6 RED «COWL Ml Sys 22 
pOeY, GON RM yp | ELP CRD Rl Dir 8 RED! DML RW Syn 
cen SYS Rw ops 2) EL MLP Ra ya 28 RED? VLR Sys 2 
Dave eND Ru Dir 10 LDCUPY «CRD QM sys 12 REDHELP FIL RW Sys 10 
DoT GOM GM Sys 'G—«LHORD. «EMD RN Sys 6 SAVE. CHD RN Sys 2 
DOTe6 CMD RM Sys 14 LOAD. «COM AW sys <2 STAT CHD. RW Dir 10 
DEMO” Doc RM Dir "2 © RAINT CRD RM Dir 28 SUBMIT CHD RM Dir 4 
DISKCOPY COM RW Dir 4 MDRIVE CMD RW Dir 2 SYSCOPY SUB RW Dir 2 
DUMP COM RW Sys 2 PIP CMD RW Dir 8 280CNF SYS RW Sys 8 
ED CMD RW Sys 10 


Screen 14. Directory After Renaming a File 
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Erasing a File 


Eventually, space on a diskette is used up as you create text files or gener- 
ate data by running programs. By using MAINT, you can erase files that 
are no longer needed and free up space. 


To erase the file FILE.TXT, move the cursor to the first letter in the file 
name, Press: 


Notice that when you press the Remove key, MAINT displays the file entry 
in dark characters on a white background, This is called a reverse video 
block. A reverse video block serves as a reminder that you have “marked” 
the file for deletion. MAINT does not delete the file until you press the Do 
key. 


Now Press: 
When you press the Do key, MAINT momentarily erases the screen. Then, 


MAINT displays the new directory (see Screen 15). Notice that FILE.TXT 
is no longer in the directory. 
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=, 
fuser 0] 
FileName Typ Attrib KBs FileName Typ Attrib KBs FileName Typ Attrib KBs 
ASH CONRU Sys @ ED. GMDIRW Sys 4B. PRACTICE Te¥ RU Dir 2 
Se EMS aye a, ROTC mn «(eee Feed Bee 
GAcKUP GHD:RW'DIV; 90 “GENGHD GMDikw' Sys G RED. OVL BN Sys. ee 
COPY. COM RU'sys =| MELE GHO.URW’Dir «Bl OREDY «VLR Sys 
con! SM RMayT GA MEL Ui de EE SOEDE, WL RA Se 
GAYE GO Orr 10 beaeY. cn. Ru'see 49° REDHELE “FILM Sys, 18 
DOF EQWARW'Syp = LMEND. CMDR Sy SAVE, OER DW Sys 
DDTeG == CMD RW Sys 14 Laap COM RM Sys 2 © STAT CMD RW Dir 10 
DEMO DOC RW Dir 2 MAINT CMD RW Dir 26 SUBMIT CMD RW Dir 4 
Diskcoey SON mAlDin a> RORTVE eMD:mA Die | SYSCORY “SUE Pa Dime 2 
DIM EC RMinys 2 PIP. ROW Mir Ms 2RQCNF “GYS\WM Sys a 


Screen 15. Directory After Erasing a File 


Canceling a Command 
If you change your mind about making changes to a file, before you press 
the Do key, you can press the Cancel key. The Cancel key instructs 


MAINT to ignore the command, The file entry is returned to its original 
state. 


Leaving MAINT 

To leave MAINT and return to the operating system, press: 

G&D 

MAINT replaces the directory display with the operating system prompt: 


A> 


BE 
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The operating system is now ready to accept another instruction, 


NOTE 

For a quick reference to each MAINT key and its 
function, press the Help key from the MAINT 
screen. MAINT is also explained in greater detail 
in Chapter 2. 


Requesting Help from the 
Operating System 


If you want to use a command but have forgotten its spelling or purpose, 
use the HELP command or the Help key. Type: 


HELP Gia) 


or 


Gree) 
The HELP program lists all the CP/M-86/80 commands. (See Screen 16). 
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HELP UTILITY v1.0 


Topics available: 


ASMa6 COMMANDS 
DIRS DISKCOPY 
HELP MAINT 
STAT SUBMIT 
HELP» 


At "HELP" enter topic (,subtopic)... 


EXAMPLE: HELP> DIR EXAMPLES 


CTRLKEYS 
ERA 

PIP 

TYPE 


DATE 
FILESPEC 
RED 

USER 


ppTes 
FORMAT 
REN 


DIR 
GENCMD 
SETUP 


Screen 16. Using the HELP Command 


For information about a specific command, type the command name next to 
the HELP> prompt and press the Return key. HELP displays the format 
and purpose of the command associated with that topic. It then instructs 


you to: 


Press Return to continue 


When you press the Return key, HELP lists isubtopics available for the 
topic you specified, To exit from HELP, press the Return key and wait for 
the A> prompt to be displayed. 
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What To Do in Case of Trouble 


If you have any trouble while using the computer, there are several steps 
to try, as described in the next three sections: 


1. Refer to a list of messages for help. 
2, Restrict the operating system. 
3. Reset the computer. 


Referring to the Operating System 
Messages 


In most cases, if the computer encounters a problem, it displays a message 
on the screen to tell you what the problem is. Messages can be displayed 
for a variety of reasons. For example, if you: 


@ Type a command incorrectly. 
© Type an invalid command. 
© Forget to type Ctrl/C after changing diskettes. 


® Omit some information the operating system needs in order to process 
the command. 


* Select a nonexistent drive. 


You cannot anticipate all the conditions that can cause a message. However, 
if you get a message: 


* Check for spelling errors. If you find any, retype the command. 


® Check for correct spacing and punctuation. A common error is to omit 
the colon (:) when specifying another diskette drive. 


* Check the list of commands in Chapter 2 to determine if the command 
you typed is a valid CP/M-86/80 command. 


® Type Ctrl/C to restart the operating system. 


* Refer to Chapter 2 for further discussion of the commands or to 
Appendix B for a list of operating system messages, what they mean, 
and what to do about them. 
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Restarting the Operating System 


If the computer is already on and you want to restart the operating system, 
type Ctrl/C directly after the prompt. You should restart the operating 
system: 


* If you change diskettes in a drive. Typing Ctrl/C directly after the 
prompt “‘logs in”’ or tells the operating system that a new diskette has 
been inserted. You can change diskettes whenever the prompt is dis- 
played and the drive lights are not lit. 


e If the computer encounters some condition that causes it to stop. 


When you type Ctrl/C (shown as “C on the screen), you should hear click- 
ing sounds from the drive and the lights beside one or more drives turn on 
momentarily one at a time. After you type Ctrl/C, the operating system 
displays its prompt, indicating you can continue. 


Resetting the Rainbow Computer 


When the operating system encounters a condition it cannot deal with, it 
may not display a message or may not respond to any key you type. If this 
happens, or if you want to start over for some reason, reset the computer. 
Resetting the computer is like turning it off and then on again without 
pressing the power switch, You reset while the computer is turned on. 
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Diskettes may be in or out of the drives. To reset the computer: 


1. Press the Set-Up key. The text in your screen should look like that in 
Screen 17. 


TO RESET TYPE <CTRL/SET-UP> 


04,058 
428k 


TABS 


iy T ul i 


r t r t r t 
1234567830 123456709 EEE 234567090 RIA 22567290 EN 


Screen 17. Set-Up Display 


2. Then type by holding down the Ctrl key while pressing the 
Set-Up key. 
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After you press these keys, the computer displays: 

TESTING... 

in reverse video block (dark characters on a light background), A few 
seconds later, the test is completed. If no problems are detected, the 
computer then displays the Main System Menu. 


To restart the operating system in drive A, type: 


Aa 
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This chapter is divided into two sections; 


~ 1. Section 1 explains some concepts about commands, special keys, files, 
and diskettes that you need to know to use the CP/M-86/80 operating 
system commands. 


2. Section 2 discusses the most frequently used commands. The com- 
mands are listed alphabetically for easy reference. 


NOTE 

For information about more advanced commands, 
refer to Information for Advanced CP/M-86/80 
Users at the end of the Preface in this guide. 
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Section 1 
Using Commands, Keys, and Files 


Using Commands 


A command generally has three parts: 


® The command, which is sometimes called a command keyword 


© The optional command tail, which supplies the command with addi- 
tional information 


e The carriage return, which tells the operating system that you are 
finished typing the command and want to execute the command 


Any combination of these parts is known as a command line. An example of 
a command line follows: 


DIR MEMO.TXT 


where: 

DIR Is the command 
MEMO.TXT Is the optional command tail 
Is the carriage return 


When typing commands, exact spacing and punctuation are important. When 
typing the examples in this guide, type the spaces and punctuation exactly 
as they are printed. In most cases, you must type at least one space after a 
command to separate it from the optional command tail. Rarely is a space 
required between the command tail and the carriage return, Additional 
spacing and punctuation requirements are noted later as each command is 
described. 
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Using Special Keys 


The following keys are special function keys that are used by the 
CP/M-86/80 operating system. 


Backspace 


The backspace key, located in the top row of keys and labeled (BS) on the 
label strip, moves the cursor to the left and erases the last character. 
Backspace works the same as the delete character key. 


Delete Character 


The delete character key, located above the Return key and labeled with an 
X, erases the last character you typed and moves the cursor back a space. 
Delete character works the same as the Backspace key. 


Return or Line Feed 


Pressing either of these two keys tells the operating system that you fin- 
ished typing a command and want the command executed, 


Hold Screen 


The Hold Screen key allows you to look at what is on the screen without 
changing it. This key is useful for long files that occupy more than one 
screen. The Hold Screen key stops the normal scrolling of a multi-page file 
after you use the TYPE command. This also means that if you type any 
additional characters, they are not displayed until you press the Hold 
Screen key again. The Hold Screen light, located above the Help key, turns 
on when you press the Hold Screen key. 
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CAUTION 
Tf you press the Hold Screen key while printing 
text on a printer, the following occurs: 


a. Printing stops until the Hold Screen key is 
pressed again. 


b. When printing resumes, extra lines or text may 
be displayed. 


Control 

The control key, Ctrl on the keyboard, is a special key used in conjunction 
with certain other keys. When the control key is combined with these other 
keys, a simple command is sent to the CP/M-86/80 operating system. 


To enter control commands, hold down the contro] key while you press the 
required letter or number key. 


Table 1 lists the control keys used by the CP/M-86/80 operating system 
and, their function. 


38 


Using CP/M-86/80 Commands 


Table 1. Control Keys 


Function Performed 


Stops a program if it is processing any console in or 
out commands; reinitializes the operating system if 
typed alone on a command line; initializes a new 
diskette. 


Moves the cursor to the left and erases the character; 
works the same as the backspace and delete character 
keys. 


Inserts eight spaces; works the same as the Tab key. 


Stops the display on the screen; works like the Return 
key and line feed key, labeled (LF) on the keyboard 
label strip. 


Works the same as the Return key. 


Prints, on the printer, everything that is written to the 
screen; a second Ctrl/P ends the repetition, This only 
works if the Rainbow computer is connected to a 
printer. 


Restarts scrolling if stopped by a Ctrl/S. Will not 
restart scrolling if scrolling was stopped by the Hold 
Screen key. 


Cir Retypes the current command line; does not send the 
command to the operating system, 


Stops console scrolling temporarily until Ctrl/Q is 
pressed; works the same as the Hold Screen key. 


Cancels the command and displays a #. The cursor 
moves down one line, and the operating system waits 
for a new command. 


Deletes all characters in the command line. 


ge 0008 88 884 Bf 


Ends a character sequence. 
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Using Files 


Most commands are designed to act on files. To correctly identify which 
file you want the command to act on, you should include a file specification 
as part of the command tail. A file specification includes the following three 
parts: 


* The location of a file, that is, which drive the diskette containing the 
file resides in. If you do not specify a drive, the operating system 
assumes the file is on the active drive. If the file is not found on the 
active drive, the operating system automatically searches all drives. If 
you want to specify a drive other than the active one, type the letter 
of the drive followed by a colon (:). The drive letter is also known as 
the drive specifier. 

* The “first name”’ of the file (the file name). 

¢ The “last name” of the file (the file type or the file extension), File 
types are often used to describe the file’s class. For example, .CMD 
and .COM file types identify programs that you can run by typing the 
file name. 


When you refer to a file, you must separate the file name and file type with 
a period. An example of a file specification is: 


A:MEMO.TXT 

where: 

A: Is the file's location: the diskette in drive A 
MEMO Is the file name 

TXT Is the file type 
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Naming Files 
Use the following conventions when naming files. 


* The file name and file type can include any combination of letters, 
numbers, and printable symbols except: 
SH gf SSF ELI 

© The file name can include from one to eight characters. The operating 
system ignores any characters after the eighth one. 

© The file type can include from one to three characters. The operating 
system ignores any characters after the third one. The use of a file 
type is optional; however, it is suggested that you use file types to 
easily identify classes of files. 


Some examples of valid file names are: 


MEMO.DOC X.Y 
PHONE.LIS a 
GAMMARAY.1 PAY-ROLL.+ 


Using File References 
A file reference identifies a particular file or group of files on a diskette. 
The CP/M-86/80 operating system accepts references for two kinds of file 


names: 


* Unambiguous file names, which identify a specific file. 


e Ambiguous file names, which identify one or more files meeting cer- 
tain criteria. 


Ambiguous file references are useful when you want to: 


® Find a file whose exact name you have forgotten 
« Enter a command that acts on several files at once 
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You use ambiguous file references by substituting a question mark (?) or an 
asterisk (*) for part of an unambiguous file name as follows: 


* A question mark matches any single character in the same position as 
the question mark. 


* An asterisk matches part of or all of an entire file name or file type. 
The asterisk could match from one to eight characters in the file name 
and from one to-three characters in the file type. 

These two ambiguous file references (? and *) are also known as wildcards, 


To see how the wildcards work, try the following examples. 


1. To list all the files on the diskette in drive A that begin with the letter 
M and have a .CMD file type (see Screen 18a), type: 


A>DIR M?229999. CMD Chatum) 
or 


DIR M*.CMD CRetura) 
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A2DIR 9727799.cMD 
A: MAINT = CMD ; MDRIVE CMD 
al 


Screen 18a. Using the Wildcard ? 
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2. To list all the files on the diskette in drive A with a .CMD file type 
(see Screen 18b), type: 


A>DIR *.CMD Grew) 


A>DIR *. CMD 
A: BACKUP CMD : DATE CMD : HELP CMD : MAINT cMD 
A: MDRIVE CMD : PIP CMD ; RED CMD ; STAT cmp 


A: SUBMIT CMD 


SYSTEM FILE(S) EXIST 
aol 


Screen 18b. Using the Wildcard * 
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Storing Information on Diskettes 


The CP/M-86/80 operating system stores files on a diskette in much the 
same way that you store files in a filing cabinet. 


e When you create a memo using a typewriter, you store it in a folder in 
a filing cabinet. 

e When you create a memo on the computer using a text editing pro- 
gram, such as RED, the operating system stores the file electronically 
on the diskette. 
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Figure 4 shows the files INFO.TXT and FILE.TXT stored in a filing cabi- 
net. Figure 5 shows the same two files stored on a diskette. (Refer to 
Appendix A, at your leisure, for more information about storing information 
on diskettes.) 


Afile isa 
collection of 
related 

information. 


CP/M is one of 
the operating 
systems that 
runs the 
Rainbow 
computer. 


Figure 4. Storing Information in a Filing Cabinet 
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FILE. TXT 
A file is a 


collection of 
related 
information. 


INFO.TXT 


CP/M is one of 
the operating 
systems that 
runs the 
Rainbow 
computer. 


Figure 5. Storing Information on a Diskette 
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Attributes 


An attribute describes the characteristics of a file or a drive. The operating 
system uses attributes to describe and control: 

¢ How files are stored and accessed 

e How drives are accessed 
You can display and change the attributes of a file or drive by using the 


STAT or MAINT commands. (Refer to the discussions of these commands 
in Section 2 of this chapter to learn how to display and change attributes.) 


The CP/M-86/80 operating system deals with the following four attributes: 


Directory (Dir) 
System (Sys) 
Read Write (RW) 
Read Only (RO) 


Se Ss 


File Attributes 


The operating system automatically assigns two attributes to a file that you 
create, as well as the files that come with your operating system diskette: 


© The Directory Attribute (Dir) 

e The Read Write Attribute (RW) 
These attributes remain in effect until you change them. 
Directory Attribute. The Directory Attribute ensures that the operating 
system stores the file name in the main directory. Whenever you type the 


DIR command, the operating system displays the file names in the main 
directory. The Directory Attribute also controls the availability of the file. 
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Read Write Attribute. The Read Write Attribute controls what you can 
do to the file. Because the file has the Read Write Attribute, you can: 


* Read the file 
e Make changes to the file 
e Erase the file 


e Rename the file 


NOTE 

You can access the file in any of the preceding 
ways providing a write-protect tab does not cover 
the diskette’s write-protect notch or the diskette 
does not reside in a drive that is write protected. 
How to assign an attribute to a drive is explained 
later in this chapter. 


If you wish, you can change these attributes to one or both of the following 
attributes by using the STAT or MAINT commands; 


* The System Attribute (Sys) 
* The Read Only Attribute (RO) 


System Attribute. The System Attribute ensures that the operating sys- 
tem stores the file name in the system directory. The system directory is a 
special directory containing only those files having the System Attribute. To 
display the files having the System Attribute, you type the DIRS command. 
The operating system does not list those file names having the System 
Attribute in response to a DIR command. 


The CP/M-86/80 master system diskette you received in the software kit 
contains the following files in the system directory (with the System 
Attribute): 


cPM.SYS Z80CNF.SYS ASM.COM ASM86.CMD 
DDT.com DDT86.CMD DUMP .COM ED.CMD 
GENCMD.CMD HELP.HLP LDCOPY.cMD LMCMD.CMD 
LOAD.COM RED. OVL RED1.OVL RED2.OVL 


REDHELP.FIL SAVE.CMD coPy.com 
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The System Attribute also controls the availability of the file. 
Assigning the System Attribute to files is useful if: 


You want to use a program or file while in any user number. 


e You have a large directory and want to store programs or files in 
another directory so that the main directory is not cluttered. 


Read Only Attribute. The Read Only Attribute controls what you can do 
to a file. Because the file has the Read Only Attribute, you can only read 
the file. You cannot; 


© Make changes to the file 
© Erase the file 
© Rename the file 


Assigning the Read Only Attribute to files is useful if you want to protect 
them from accidental deletion, 


Drive Attributes. The operating system also assigns a Read Write Attri- 
bute to drives. This attribute remains in effect until you change it. Unless 
you change the Read Write Attribute, all files on any diskette in the drive 
can be: 

© Read 

© Changed 

e Erased 

e Renamed 
However, this attribute is overridden if a file has the Read Only Attribute 
or if the diskette has a write-protect tab on the write-protect notch. The 


write-protect tab has priority over the write-protect status of a diskette or 
a file. 
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You can temporarily change a drive’s Read Write Attribute to the Read 
Only Attribute by using the STAT command. (Refer to Section 2 of this 
chapter for more information about the STAT command.) The files residing 
on a diskette in a Read Only drive are protected from being accidentally 
deleted or changed. 


It is not a good idea to assign the Read Only Attribute to a drive to protect 
files, because the protection is only temporary. The Read Only Attribute of 
a drive is reversed by typing Ctrl/C. Because you type Ctrl/C to reinitialize 
the operating system, you can easily reverse the Read Only Attribute 
without realizing it. If you want to protect all files on a diskette, place a 
write-protect tab on the write-protect notch of the diskette. 
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Section 2 
CP/M-86/80 Operating System 
Commands 


The operating system has two types of commands; built-in and transient, 
Table 2 lists the characteristics of transient and built-in commands. 


Table 2. Transient and Built-in Command Characteristics 


Built-in Commands Transient Commands 

Not shown on directory Shown on directory 

Always stored in the computer; automatical- _ Stored as files on a diskette; read into the 
ly read into the computer at start-up computer only when requested 

Can be used at any time regardless of Can only be used if the requested file exists 


which diskette or user number is being used _ on the active diskette or if you specify the 
diskette where the the file exists 


When you type a command, the operating system does one of the following: 


* Finds the command in the computer and runs the command immedi- 
ately (built-in). 
e Displays the command you typed followed by a question mark (?) if the 


command cannot be found in the computer or on the diskette. Usually, 
this happens because you mistyped a command. 


* Finds the program file associated with the command on the diskette; 
reads the program file into the computer and runs it (transient). (For 
example, the command PIP runs the program PIP.CMD.) 
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If the operating system cannot find the transient program file on the active 
drive, it automatically looks on the drive from which you started the operat- 
ing system, In some cases, the command you type results in a report of 
both drives. For example, if you start the operating system form drive A, 
and then you work from a diskette in drive B, when you use the STAT 
command, the operating system displays the diskette information for both 
drive A and B. The following is an example: 


AdB: CRewm 
BosTaT Glew) 


A: RW, Free Space: 70k 
B: RW, Free Space: 352k 


B> 


Table 3 lists the commands discussed in this chapter, as well as RED, 
which is described in Chapter 3. 
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Table 3. CP/M-86/80 Operating System Commands 


Command Use 

BACKUP. Copies the indicated file from the hard disk to a set of diskettes, 
or from the diskettes to the hard disk (See chapters 5 and 6 
for information on this program.) 

DATE Displays or sets the date and time 

DIR Displays files with the Directory Attribute 

DIRS Displays files with the System Attribute 

DISKCOPY Reproduces the entire contents of one Rainbow diskette on an- 
other 

ERA Erases a file 

FORMAT Formats a blank diskette for use by CP/M-86/80 on a Rainbow 
computer 

HELP Displays summary information, on the screen, about a command 

MAINT Renames, erases, changes the attributes of files, or displays the 
contents of a file. MAINT can be used in place of DIR, DIRS, 
ERA, REN, STAT, or TYPE 

MDRIVE Installs and configures the memory drive (M:) 

PIP Transfers one or more files from one device to another, for 
example, from a diskette to another diskette, or from a diskette 
to a printer 

RED Creates or edits a file 

REN Changes the name of a file 

STAT Displays information about files, drives, and other components of 
the computer 

SUBMIT Executes a series of commands through one command 

TYPE Displays the contents of a text file 

USER Displays and changes the current user number 


The commands listed in Table 4 are mainly for programmers. They are 
stored on the CP/M-86/80 master system diskette in the system directory. 
For information about these commands, refer to the Rainbow Technical 
Documentation Kit, explained at the end of the Preface in this guide. 
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Table 4. Additional Commands 


Command Use 

ASM Assembles CP/M-80 programs 

ASM86 Assembles CP/M-86 programs 

DDT Debugs CP/M-80 programs 

DDT86, Debugs CP/M-86 programs 

DUMP Displays files in hexadecimal form 

ED Creates and edits files 

GENCMD Produces command files (.CMD) from hexadecimal files 

LDCOPY Copies the two reserved system tracks from one diskette to 
another 

LMCMD Produces command files (,CMD) from Intel-L module files 

LOAD Produces command files (.COM) from hexadecimal files 

SAVE Saves CP/M-80 programs in memory as a file on the diskette 


NOTE 

DUMP displays files in hexadecimal form. DUMP 
attempts to interpret the file’s contents in 7-bit 
ASCII codes or optionally in DIGITALs 8-bit mul- 
tinational character set. 


To display the file in 7-bit ASCII code, type the 
following command; 


DUMP [dev:1filename. typ CReum 


To display the file in DIGITALs 8-bit multinational 
character set, type the following command: 


DUMP (drv:]filename.typ 8 Cheum) 
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Conventions Used 


Table 5 lists the conventions used in the discussions of the commands. 


Table 5. Conventions 


Convention Meaning 

n Number 

filename File name (maximum of eight characters) 

styp File type (maximum of three characters) 

filespec File specification (maximum of 14 characters: two for drive 
name, eight for file name, one period separator, three for file 
type) 

dry: Valid drive name as follows: 
A: or B: for the two standard drives 
C: or D: if the optional drives are installed 
E:, F:, G:, or H: if the optional hard disk is installed in place of 
C: and D: 
M: if MDRIVE is configured 

atr Attribute (RO, RW, Dir, Sys) 

Ip] Parameter used with PIP 

dey Device 

dey1 First device 

dev2 Second device 

logdev Logical device 

phydev Physical device 


Optional portions of a command are shown in brackets, | |, which you do 
not type. Note, however, that when you include optional parameters with 
the PIP command, you must also include the brackets. 
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DATE 


Purpose 


DATE is a transient command that displays the current date and time or 
allows you to set the date and time. 


Form 


DATE [dd-mon-yy hh:mm:ss] [P] Gaetum > 


Instructions 


Type the command followed by the optional date and time. The date is 
represented as: 


day-first 3 letters of month-last 2 digits of year 

For example, 

23-jul-83 

Time is represented as a twenty-four hour clock with hour values from 00 
to 11 for the morning, and 12 to 23 for the afternoon and evening. If you 
omit the date and time, DATE displays the current date and time. If you 


include the P option, DATE displays the current date and time continuously 
until you press any key. 
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Examples 
The following examples assume drive A is the active drive. 
1. Display the current date and time: 


A> DATE CRetum) 
2. Set the date and time to 10:30 a.m. on the sixth of June, 1983: 


A>DATE 06-jun-83 10:30:00 (Remm) 


3. Display the current date and time continuously: 


A>DATE P CReum) 
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DIR 


Purpose 


DIR is a built-in command that displays a list of file names having the 
Directory Attribute. 


Form 


DIR [drv:|[filename.typ] 


Instructions 

Type the command followed by the optional drive name, file name, and file 
type. If you omit the drive name, DIR assumes the active drive. If you omit 
a file name and file type, DIR displays all file names on the specified disk- 
ette that have the Directory Attribute. DIR accepts wildcards (? and *) in 
the file name and file type. If the diskette includes files with the System 
Attribute, and you request a complete directory by typing DIR without a 
file name, DIR displays the following message after the directory: 


SYSTEM FILECS) EXIST 


Examples 
The following examples assume drive A is the active drive. 


1. Display a complete directory of file names having the Directory 
Attribute: 


A>DIR CRewm ) 


2. Display the directory of the file SHOW.SUB having the Directory 
Attribute: 


A>DIR SHOW. SUB Chenm) 
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Display a directory of all files with the file name HELP having the 
Directory Attribute: 


A>DIR HELP.* 


Display a directory of all files on the diskette in drive B with the file 
type .TXT having the Directory Attribute: 


A>DIR B:*. TXT Geum) 


DIRS 


DIRS 


Purpose 


DIRS is a built-in command that displays a list of file names having the 
System Attribute. 


Form 


DIRS [dry:||filename.typ] 


Instructions 

Type the command followed by the optional drive name, file name, and file 
type. If you omit the drive name, DIRS assumes the active drive. If you 
omit a file name and file type, DIRS displays all file names on the specified 
diskette that have the System Attribute. DIRS accepts wildcards in the file 
name and file type. If the diskette includes files with the Directory Attri- 
bute, and you request a complete directory by typing DIRS without a file 
name, DIRS displays the following message after displaying the directory: 


NON-SYSTEM FILECS) EXIST 


Examples 
The following examples assume drive A is the active drive. 


1. Display a complete directory of file names having the System 
Attribute: 


A>DIRS CRewm 


2. Display the directory of the file SHOW.SUB having the System 
Attribute: 


A>DIRS SHOW. SUB Chew ) 
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Display a directory of all files with the file name HELP having the 
System Attribute: 


A>DIRS HELP. * Cieum) 


Display a directory of all files on the diskette in drive B with the file 
type .CMD having the System Attribute: 


A>DIRS Br *.CMD Gieum) 


NOTE 
If you request the directory listing of a file that 
does not exist, the computer displays: 


NO FILE 


DISKCOPY 


DISKCOPY 


Purpose 


DISKCOPY is a transient command that reproduces the entire contents of 
one Rainbow diskette to another Rainbow diskette. Use this command to 
make back-up copies of: 


© The CP/M-86/80 system diskette 
* Application program diskettes 
© Data diskettes 


NOTE 

Use DISKCOPY with caution, If there are already 
files on the destination diskette (the diskette to 
which you are copying the files), these files will be 
erased and replaced with the new files from the 
source diskette. 


Form 


DISKCOPY Caetum) 


Instructions 


Type the command and answer the questions that the DISKCOPY program 
asks you. DISKCOPY copies the diskette in drive A to the diskette in drive 
B unless you specify other source and destination drives. You can make 
additional copies of the source diskette after the first copy is made without 
exiting from the program. 


The computer beeps if you press an invalid key while answering the 


DISKCOPY questions. The character is not displayed on the screen. Press 
the correct key if this occurs. 
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Press the Exit key if you want to stop the program and return to the 
operating system. If you press the Exit key during the copying process, the 
program stops. 

If you are copying a data diskette on a two-drive computer, remove the 
system diskette from its drive when the program asks you to insert the 
source and destination diskettes. Insert the data diskette you want to copy 
from and then press the Y key to start the copying process. The program is 
now stored in the computer and the copying process can proceed even 
though the system diskette is no longer inserted in the drive. The program 
later instructs you to reinsert the system diskette into the drive, 


The destination diskette cannot have a write-protect tab on the write- 
protect notch. 


If the DISKCOPY program stops for any reason, 


© Correct the problem and run DISKCOPY again. 
* Discard the diskette if the DISKCOPY program stops again. 


Example 


Copy the operating system diskette in drive A (source diskette) to a blank 
diskette in drive B (destination diskette). 


1. Type: 
AsDISKCOPY Gimum) 
The program displays: 


Copy from source diskette in drive A 
to destination diskette in drive B 


Are the drives correct? CY/N) 
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2. Press: 


Y 


The program displays a message appropriate to your selection. This 
example uses A as the source diskette and B as the destination 
diskette, so DISKCOPY displays: 


Insert source diskette into drive A 
Insert destination diskette into drive B 


Ready to start copying? CY/N> 
At this point, if you want to: 


© Copy a data diskette on a two-drive computer, remove the 
system diskette from drive A and insert the new source diskette 
into drive A. 


e Change the source or destination diskette, press the N key. 
The program asks you to select the source drive (A through D). 
The program then asks you to select the destination drive, giving 
you the same choices minus the one you selected for the source 
diskette. 


© Copy the diskette in drive A to the diskette in drive B, press the Y 
key. 


For this example, press: 

w 

The program displays: 

Copying all tracks 

Reading track tt Writing track tt 


The characters, tt, indicate which of the 80 tracks (numbered 0-79) is 
currently being read or written, 
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5. 
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When the copying process is complete, DISKCOPY displays a message 
appropriate to your response, This example uses B as the destination 
diskette, so DISKCOPY displays: 


Copy/Verify complete to drive B 
Do you want another copy? (Y/N) 


In this example, you have made a single copy of the source diskette. If 
you want to make more copies, press the Y key, Then remove the 
diskette from the destination drive and insert another blank diskette. 
DISKCOPY then asks you if you want to copy the diskette in drive A 
to the diskette in drive B again. Repeat the steps listed above. 


Because this example makes a single copy of the source diskette, 
proceed to step 4. 


Press: 
N 
The program displays: 
INSERT CP/M-86/80 SYSTEM DISKETTE then press the Exit key. 
Press: 
Ga) 
NOTE 
If you have copied a data diskette, insert the 
system diskette before pressing the Exit key. The 


system diskette is automatically “logged in” when 
you press the Exit key. 


DISKCOPY 


The program ends and the operating system displays its prompt: 


A> 


IMPORTANT 

Tf you look at a directory (refer to the DIR 
command) of the newly copied diskette, all the 
copied file names are listed. However, if, for any 
reason, the DISKCOPY operation did not 
complete, the contents of some of the file names 
listed may not exist. In such a case, erase all file 
names from the diskette (refer to the ERA 
command) and run DISKCOPY again. 
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ERA 


Purpose 


ERA is a built-in command that erases a file or group of files from a 
diskette directory. 


CAUTION 
Use ERA with care because erased files cannot be 
restored. 


To protect files from accidental deletion: 


« Place a write-protect tab on the diskette’s write-protect notch. The 
tab protects all files on the diskette. (Refer to Appendix A). 


© Set the file(s) to the Read Only Attribute. (Refer to the discussions of 
the MAINT or STAT commands.) 


* Keep back-up copies of the diskettes. (Refer to the discussion of the 
DISKCOPY command.) 


Form 


ERA [drv:|filename.typ Geum) 


Instructions 


Type the command followed by the optional drive name, the file name, and 
the file type. If you omit the drive name, ERA assumes the active drive. 


ERA accepts wildcards in the file name and file type. Verify a deletion by 
using the DIR or DIRS command. 


When you type a command to erase all files on a diskette, ERA displays the 
following message to confirm that you want to erase all the files. 


ALL CY/ND? 
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To erase all the files, type: 


\ jam) 


To stop the command without erasing any files, type: 


N Chetan) 


Examples 


The following examples assume drive A is the active drive. 


Ne 


Erase the file TEST.TXT: 

A>ERA TEST. TXT Crown) 

Erase all files with the file type .TXT: 
A>ERA *.TXT Chem) 

Erase all files: 


ADERA *.* Gieum) 
ALL CY/N)?Y CRetum ) 


Erase all the files with the file name TEST on the diskette in drive B: 


ADERA BrTEST.* CRewm) 
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Purpose 


FORMAT is a transient command that prepares a blank diskette for file 
storage and use by CP/M-86/80 on the Rainbow computer. 


Form 


FORMAT 


Instructions 


Type the command and answer the questions that the FORMAT program 
asks you. FORMAT prepares the diskette in drive B unless an alternate 
destination drive is specified. 


The computer beeps if you press an invalid key, and the key is ignored, 
The character is not displayed on the screen. Press the correct key if this 
occurs. 


Press the Exit key if you want to stop the program and return to the 
operating system. If you press the Exit key during the formatting process, 
the program stops. 


Insert the diskette you want to format and then press the Y key to start 
the formatting process. 


The destination diskette cannot have a write-protect tab on the write-pro- 
tect notch. 


CAUTION 


FORMAT will destroy any existing information on 
the destination diskette. 
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Example 
Type: 
A> FORMAT Chewm ) 


The program displays an introductory message at the top half of the screen 
followed by: 


Selected Drive: B 
Select drive for formatting (A, B, C, D, or for NO CHANGED 
The program then displayes a message appropriate to your selection. 
FORMAT then asks if you are: 
Ready to format diskette in selected drive? (Y/N) 
At this point you can: 
¢ Format the diskette in drive B by typing 
y 
* Change the selected drive by typing 
N 
The program repeats the instruction to select a drive. 
If you type Y, the program displays: 
Formating all tracks 


After a few seconds during which you hear clicking sounds, FORMAT 
displays: 


Verifying all tracks 
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Assuming you selected drive B, when the formatting process is complete, 
FORMAT displays: 


Format/Verify complete to drive B 

Do you want to format another diskette? CY/N) 

If you want to format more diskettes, type Y. Otherwise, type N. 
FORMAT displays: 

Insert CP/M-86/80 SYSTEM DISKETTE then press Exit 


Press: 


C 


En) 
The program ends and the operating system displays its prompt: 


A> 
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HELP 


Purpose 


HELP is a transient command that displays summarized information about 
the following CP/M-86/80 topics and subtopics: 


ASM86/Examples 
DIR/Example 
PIP/Options/Examples 
TYPE/Examples 
COMMANDS/Table 
DIRS/Examples 
RED/Commands/Keys 
MAINT/Keys/Examples 
SETUP/Keys 
DATE/Examples 
FILESPEC 


Form 


USER/Examples 
STAT/Options/Examples 
DISKCOPY 
ERA/Examples 
DDT86/Commands/Parameters/Examples 
REN/Examples 
CTRLKEYS/Table 
GENCMD/Examples 
SUBMIT/Examples 
HELP 

FORMAT 


HELP [topic] [subtopic] Geum) 


where: 


HELP 
HELP [topic] 


HELP [topic] [subtopic] 


Displays a list of topics for which information is 
available. 


Displays information about the specified topic 
and a list of available subtopics. 


Displays information about the specified 
subtopic. 
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Instructions 
There are two ways to use the HELP command: 


¢ Type the command followed by any desired topic or topic and 
subtopic; for example: 


A>HELP ERA (Renun ) 


HELP displays information about ERA and then lists the additional 
options. 


° Type the command alone. HELP displays its own prompt, HELP>. 
Then type enough characters of any desired topic, or topic and 
subtopic, to make it unique, For example, to display information about 
MAINT keys, type: 


AdHELP CRemm ) 


HELP>™ K CRetum ) 


Press the Return key next to the HELP prompt to return to the operating 
system prompt. 


NOTE 

You can also use the Help key located in the top 
row of keys, When you press the Help key, the 
same list of topics is displayed, followed by the 
HELP> prompt. 
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Examples 
The following examples assume drive A is the active drive. 
1. Display a list of available topics: 
A> HELP CRemm) 


2. Display information about the ERA command and display the available 
subtopics: 


A>HELP ERA Chou) 

3. Display examples (a subtopic) of the ERA command: 
AHELP ERA EXAMPLES CRewm) 

4. Display information on how to use HELP: 
A>HELP HELP Gia) 


5. Display more than one subtopic without returning to the operating 
system in between: 


A>HELP (few) 
HELP>DISKCOPY CRewm) 


HELP>ERA EXAMPLES (Rein ) 


HELP» (Bours) 


A> 
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Purpose 


MAINT is a transient command that runs the file maintenance program. 
MAINT lets you perform the routine “housekeeping” tasks associated with 
using a diskette. MAINT combines the functions of the TYPE, DIR, DIRS, 
ERA, REN, and STAT commands. 


MAINT displays the directory of the active diskette one screen at a time. 
While viewing the directory, you can moye the cursor from file to file and 
select as many files as you want for changes. You can implement all the 
changes at one time by pressing the Do key. You can cancel the last file 
selected for changes (before pressing the Do key) by pressing the Cancel 
key, or all files selected for changes by pressing the Exit key. 


While using MAINT, you can: 


© Change file names, file types, or attributes 

° Delete files 

e Page through the directory forward and backward 
© Get information about a diskette 

e Display the contents of text files 


Refer to Screens 12 through 15 in Chapter 1 of this guide for visual exam- 
ples of using MAINT. 


MAINT is particularly useful if you have a large directory and want to 
erase unneeded files. Normally, you would: 


1. List all the files (with the directory attribute) on the diskette by using 
the DIR command 
2. Write down or ‘“‘mark” on paper all the files you want to delete 


3. Erase each file one by one using the ERA command 
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To do this using MAINT, you can: 
1, List all the files on the diskette. 


NOTE 

MAINT lists ail the files on the diskette, where 
DIR only lists the files with the directory 
attribute. 


2. Use special function keys to move the cursor to the files that you 
want to delete 


3. Select each file for deletion by pressing the Remove key 
4. Press the Do key to delete all the files that you selected 


Form 


MAINT [dry:][filename.typ] 


Instructions 


Type the command followed by the optional drive name, file name, and file 
type. If you omit the drive name, MAINT assumes the active drive. If you 
omit a file name and file type, MAINT displays all file names on the speci- 
fied diskette having both the Directory and System Attributes. MAINT 
accepts wildcards in the file name and file type. 


The computer beeps whenever you press a key that MAINT does not rec- 
ognize, or whenever you try to make a change that is invalid (such as 
deleting a Read Only file). 


While using MAINT, you cannot: 
1. Rename, erase, or change the attributes of files that: 


° Have the Read Only Attribute 
¢ Reside in a drive that has the Read Only Attribute 
* Are stored on a diskette that has a write-protect tab on it 
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2. Make more than one change to a file at a time. You must complete 
the first change before making a second change. 


3. Change a file size. 


Running MAINT. After you type the command, MAINT displays the first 
screen or “page” (19 lines) of the diskette’s directory. 


The first line of the directory lists the drive, file specification, and user 
number within a reverse video block (dark characters on a light back- 
ground). At the bottom of the screen, MAINT displays the following line 
within a reverse video block: 


Press "Exit" to quit, “Help" for more information. 


MAINT displays these lines on each page of the directory including the 
diskette summary. 


If you press the Exit key, you are returned to the operating system 
prompt. 


If you press the Help key, MAINT replaces the current directory display 
with a list of MAINT keys and functions. To return to the current direc- 
tory, press any key, 


NOTE 

If you specify a nonexistent file or if there are no 
files stored on the diskette, MAINT displays the 
diskette summary. 


MAINT displays the directory in a three-column, alphabetized format. The 
following header is displayed at the top of each column: 


FileName Typ Attrib KBs 


where; 

FileName Is the file name 

Typ Is the file type 

Attrib Are the file’s attributes 
KBs Is the file’s size in kilobytes 
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NOTE 

A byte is the amount of memory required to store 
one character; a kilobyte is 1024 bytes. You can 
store 386 kilobytes on a Rainbow diskette, or 
about 150 pages of text. 


After MAINT displays the first screen of the directory, you can “page”’ 
through the directory, forward and backward, using the Prev Screen and 
Next Screen keys. If the diskette’s directory fits onto one page, pressing 
the Next Screen or the Prev Screen key causes MAINT to display the 
diskette summary. (The diskette summary is the last page of any direc- 
tory.) MAINT displays the following information about the diskette: 


File Space Allocation Summary 


This User 
Other Users : 
Available 
Total 


Diskette Access: R/W 


where: 

KBs the number of kilobytes used 

FCBs The number of file control blocks used 

This User: The number of KBs and FCBs used by the cur- 
rent user number 

Other Users: The number of KBs and FCBs used by other 
user numbers 

Available: The total number of KBs and FCBs available 

Total: The total number of KBs and FCBs used by all 
user numbers 

Diskette Access: The attribute (access mode) of the drive 
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NOTE 

A file control block contains the information nec- 
essary for the operating system to access the file, 
such as the file name, file type, and file size. 


Positioning the Cursor. To use the various functions of MAINT, you 
must tell MAINT which file to act on. To do this, you move the cursor to 
different positions within the desired file entry. A file entry consists of the 
file Name, Typ, Attrib, and KBs (kilobytes). 


After you move the cursor to the desired file entry, you can then use the 
special function keys to perform the different housekeeping tasks. Table 6 
lists the cursor control keys and the special function keys used by MAINT; 
Figure 6 shows the location of these keys on the keyboard. 


Addtni 
Cancel Exit Options Help Do Remove 


a ae i ta] 
Bay /L 


Tab Return Find/ Prev Next Screen 
Screen Directional 
Select Arrow Keys 


Figure 6. MAINT Keys 
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Table 6. MAINT Keys 


Key 


Function 


Up Arrow ( @ ) 
Down Arrow ( # ) 
Right Arrow ( # ) 
Left Arrow ( # ) 
Tab 


Return 


Next Screen 


Prey Screen 


Remove 


Addtnl Options 
Do 


Cancel 


Exit 


Find 


Help 


Select 


Moves the cursor up one line at a time. 

Moves the cursor down one line at a time. 
Moves the cursor right one character at a time. 
Moves the cursor left one character at a time. 


Moves the cursor horizontally to the first character of 
the next file entry. 


Moves the cursor to the first character of the next line 
in the current column. 


Displays the next page of the directory; displays the 
next page of a text file. 


Displays the previous page of the directory. 


“Marks” a file for deletion by displaying the file name 
and attributes in reverse video. 


Displays a text file, 
Implements all the selected changes on the directory. 


Cancels the change for the file that the cursor is cur- 
rently positioned on. 


Cancels all selected changes and returns to the operat- 
ing system if pressed before the Do key; returns to the 
directory if displaying a file; returns to the operating 
system prompt. 


Cancels all selected changes and returns to the 
operating system prompt. 


Moves the cursor to the first character of the first file 
entry at the upper left corner of the screen. 


Displays a list of MAINT keys and functions. 


Moves the cursor horizontally to the first character of 
the previous file entry (the opposite function of the 
TAB key). 
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You can move the cursor with the keys listed in Table 6 only to the 
positions within a file entry that can be changed. For example, you cannot 
change the size of a file, so MAINT does not allow you to move the cursor 
to the file size. MAINT jumps over those positions within the file entry. 
MAINT does not allow you to move the cursor on the following characters 
within the file entry: 


The “R” in the “RW” or ‘‘RO” attribute. (You can move the cursor to 
the ‘‘W” or “‘O” because they are the only characters that change.) 


The second two characters of the “Dir’’ or “Sys” attribute. (When 
you type the first character of the new attribute, either ““D” or “S”, 
MAINT changes the remaining two characters of the attribute 
accordingly.) 


The file size. 


Renaming a File Name or File Type. To rename a file name or file 
type, follow the instructions below. 


Ty 
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Move the cursor to the first character of the file name or file type (or 
to the characters that are changing) using the directional arrow, Tab, 
Select, Find, or Return keys. 


Type the new file name over the old file name. 


NOTE 

The characters you type are displayed on the 
screen in the same case as the characters that you 
are typing over regardless of whether you are 
using the Shift or Lock keys. 


e You must follow the file naming conventions for files (see the sec- 
tion titled “Naming Files” earlier in this chapter). MAINT ignores 
any illegal characters as part of the file name or file type, such as a 
comma, and does not display them on the screen. 


© When you type the first character of the new file name or file type, 
MAINT displays the file entry in boldface characters. This serves 
as a reminder that you have selected this file for a name change. 


3. 
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e If the new file name has fewer characters than the old file name, 
press the space bar to delete the remaining unwanted characters of 
the old file name. MAINT ignores any more than eight characters. 


Now, you can either change the name or cancel the name change. 


® If you decide to keep the old file name, move the cursor to any 
character within the file entry and press the Cancel key. MAINT 
redisplays the old file name and returns the file entry to its original 
state. 


© If you decide to change the name, press the Do key. After you 
press the Do key, MAINT erases the screen and then redisplays 
the directory with the new file name or file type. The new file 
name is displayed in the directory according to where it falls 
alphabetically. 


Changing a File Attribute. To change a file attribute (RO, RW, Dir, 
Sys), follow the instructions below. You can only change one attribute at a 
time. 


4. 


Move the cursor to the “O”, “W”, “D”, or “S” by using the direc- 
tional arrow, Tab, Select, Find, or Return keys. 


Type the new attribute over the old attribute. 


e MAINT only accepts the characters “W” and “O” for the RW or 
RO Attributes and “D” and “S” for the Dir and Sys Attributes. 
MAINT ignores any other characters. To change the RW or RO 
Attribute, move the cursor to the “W” or “O” and type the 
change. 

To change the Dir or Sys attribute, move the cursor to the “D” or 
“S” and type the change. When you type the “D” or “S”, MAINT 
changes the remaining two characters of the attribute accordingly. 


When you type the first character of the new attribute, MAINT 
displays the file entry in boldface characters to remind you that the 
file is selected for an attribute change. 
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3. Now, you can either change the attribute or cancel the attribute 
change. 


* If you decide to keep the old attribute, move the cursor to any 
character within the file entry and press the Cancel key. MAINT 
redisplays the old attribute and returns the file entry to its original 
state. 


* If you decide to change the attribute, press the Do key. After you 
press the Do key, MAINT erases the screen and then redisplays 
the directory with the new attribute. 


Erasing a File. To erase a file, follow the instructions below. 


1. Move the cursor to any character of the file entry using the direc- 
tional arrow, Select, Find, Tab, or Return keys. 


2. Press the Remove key. When you press the Remove key, MAINT 
displays the file entry within a reverse video block to remind you that 
the file is selected for deletion. 


3. Now, you can either delete the file or keep the file. 


e If you decide to keep the file, move the cursor to any character 
within the file entry and press the Cancel key. MAINT returns the 
file entry to its original state. 


e If you decide to delete the file, press the Do key. After you press 
the Do key, MAINT erases the screen and then redisplays the 
directory without the file name. 


© If you erase all files from a directory page, MAINT displays the 
previous directory if one existed. 


Displaying a File. To display the contents of a text file, follow the 
instructions below. Do not use MAINT to display nontext files such as 
those with file types .COM, .CMD, or .SYS. If you accidentally display a 
nontext file, the screen can become garbled, and the computer can stop. If 
this happens, reset the computer by pressing the Set-Up key, and followed 
by the Ctrl/Set-Up keys. 
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1. Move the cursor to any character of the file entry by using the direc- 
tional arrow, Select, Find, Tab, or Return keys. 


2, Press the Addtnl Options key. 


When you press the Addtnl Options key, MAINT erases the directory 
from the screen and then displays a one-line header in reverse video 
block at the top of the screen. The header lists the drive name, file 
specification, and user number, MAINT also displays the following line 
at the bottom of each screen: 


Press "Exit" for directory, "Next Screen" to continue, 


MAINT displays these top and bottom lines on each page of the file. 


When you then press the Exit key, you are returned to the current 
directory display. 

When you press the Next Screen key, MAINT displays the next page 
of the file if there is one. If the last page of the file is already dis- 
played, when you press the Next Screen key, MAINT displays the 
current directory. 


NOTE 
While you are using MAINT to display a file, you 
cannot use the Prev Screen key. 


When you type Ctrl/C, you are returned to the operating system 
prompt. 


NOTE 

The file cannot be changed while it is displayed. 
MAINT ignores any keys that you press while the 
file is displayed on the screen. 
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Correcting Mistakes. You can change your mind or correct mistakes as 
long as you have not pressed the Do key, To do this, press the: 


* Cancel key: This key causes MAINT to cancel the change on the file 
entry where the cursor is currently positioned. MAINT returns the 
entry to its original state, that is, without the boldface characters or 
reverse video block. Other selected changes are unaffected. MAINT 
continues to display the directory on the screen, and you are free to 
make additional changes or press the Do key to implement the other 
changes. 


e Exit key: This key causes MAINT to cancel all changes that you have 
selected and returns you to the operating system prompt. 


© (ae): This combination of keys causes MAINT to cancel a// changes 
that you have selected and returns you to the operating system 
prompt. 


For a list of MAINT keys and their functions, press the Help key. To 
return to the current directory, press any key. 


Exiting MAINT. To exit MAINT while viewing the directory, you can: 


© Press the Exit key. 
© Type: 


You are then returned to the operating system prompt. 
Examples 


The following examples assume drive A is the active drive. 


1. Display the first page of the directory of all the files having the 
Directory and the System Attributes. 


A> MAINT (Remum 
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. Display the contents of MEMO.TXT. 


Move the cursor by using the directional arrow, Tab, Select, Find, 
or Return keys to any character of the MEMO.TXT file entry. 
(The cursor can be on any character including a blank space.) 


Press: 


(asin Spiions ™) 
MAINT erases the screen and displays the first screen of 
MEMO.TXT, 


To view the next screen of the file, press the Next Screen key. 
(Pressing the Next Screen key on the last page of file causes 
MAINT to return to the directory.) 


To return to the directory at any time, press the Exit key. 


Rename MEMO.TXT to LETTER.TXT. 


Move the cursor to the first character in the file name, in this 
case, M. 


Type: 
L 


As soon as you type the first new character (L), MAINT displays 
the entry in boldface characters. 


Type the remaining characters: 
ETTER 


NOTE 

Remember, if you decide not to change the old 
file name before pressing the Do key, move the 
cursor to any character within the file entry. 
Then, press the Cancel key. MAINT redisplays 
the old file name and returns the file entry to its 
original state. 
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e This example changes the file name. Press: 
Ga) 


® MAINT changes the name and alphabetically lists the new name, 
LETTER.TXT, in the directory. 


4, Change the RW (Read Write) Attribute of the file LETTER.TXT to 
the RO (Read Only) Attribute. 
© Move the cursor to the W in RW. 
© Type: 
a 


e As soon as you type O, MAINT displays the file entry in boldface 
characters. 


NOTE 

Remember, if you decide not to change the old 
attribute before pressing the Do key, move the 
cursor to any character within the file entry. 
Then, press the Cancel key. MAINT redisplays 
the old attribute and returns the file entry to its 
original state. 


© This example changes the attribute. Press: 


to) 


© MAINT changes the attribute and lists the new attribute, RO, in 
the attribute column of the directory. 
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5. Erase the file TEST. TXT. 


*® Move the cursor to any character within the TEST.TXT file entry. 
The file must have the RW attribute. The cursor can be on any 
character including a blank space. 


e Press: 


e As soon as you press the Remove key, MAINT displays the file 
entry within a reverse video block. 


NOTE 

Remember, if you decide not to erase the file 
before pressing the Do key, move the cursor to 
any character within the file entry, Then, press 
the Cancel key. MAINT returns the file entry to 
its original state. 


e This example erases the file. Press: 


@s) 


© MAINT makes the change and lists the new directory without the 
file, TEST. TXT. 


Remember that all of the changes shown in the examples above can be 
made by: 


© Moving the cursor from file to file 
® Marking the change in each file 
® Pressing the Do key to implement all the changes 
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Purpose 


MDRIVE is a transient command that informs the CP/M-86/80 operating 
system that you wish to install or remove the memory drive. 


The memory drive is a virtual disk drive. The CP/M-86/80 operating sys- 
tem uses the memory, which you allocate, as though it were a diskette 
drive. Any CP/M-86/80 operating system commands that reference or use a 
diskette drive are valid for the memory drive. 

Because a memory drive does not depend on the mechanical rotation of a 


diskette, the reading and writing operations on a memory drive are much 
faster than on a diskette drive. 


Form 


MDRIVE [n] 


Instructions 
MDRIVE allows you to allocate memory in 64K byte blocks. 
The first 128K bytes of memory are reserved for the CP/M-86/80 operating 


system and application programs. To use the MDRIVE command success- 
fully, you must have at least 192K bytes of memory. 


Examples 
The MDRIVE examples assume that a total of 330K bytes of memory are 
available, The 330K byte total includes the 128K bytes from the system 
unit and a 192K byte memory option. 

1. When you do not know how much memory you can allocate, type: 


A>MDRIVE CReture) 
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The program responds with: 


The M: Drive consists of 1 or more 64k blocks which are 
allocated from available system memory. 


There are 3 64k blocks available 


Type in the number of blocks desired followed by return. 
(1--3): 


You respond with a number, for example: 

2 Gown) 

The program confirms that: 

M: drive installed. Available file space = 126k 

A> 

You can also specify the number of blocks on the same line as the 
MDRIVE command. The following example allocates the same amount 


of memory as the previous example: 


A>MDRIVE 2 (Retum ) 


The program responds with: 
M: drive installed. Available file space = 126k 
A> 
NOTE 
MDRIVE reports an available file space that is 
always slightly less than the amount you specified. 


The operating system uses the extra space to 
store the memory drive files directory. 
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3. 
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The name of the memory drive is M. You can make drive M the 
default drive by typing: 


A>M: CRewm ) 
After drive M is installed, it is blank. It does not contain any files. If 


you wish to run an application program from drive M, you must use 
the PIP command to copy the program to drive M. 


You can remove the M drive by specifying zero 64K blocks as in the 
following example: 


M>A: Chewm) 
A>MDRIVE 0 Chew) 


The program responds with: 


M: drive removed. 


A> 


If you do not remember that you have already installed the memory 
drive, the following dialog takes place: 


A>MDRIVE Geum) 


M: Drive already configured on this system 
Do you wish to remove it CY or N): 


NOTE 
Do not attempt to remove drive M when it is the 
active drive. 


If you have saved any new or modified data on 
drive M, use the PIP command to copy the data 
onto a diskette before removing the M drive. 
When you remove the M drive or turn the 
Rainbow computer off, any data on drive M is 
lost. 


WARNING. 

Some application programs require more than 
128K bytes. If you intend to run an application 
that requires more than 128K bytes, then you 
must allow more memory for the application by 
allocating less memory for the memory drive. 


MDRIVE 
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Purpose 


PIP (Peripheral Interchange Program) is a transient command that trans- 
fers files from one device to another, such as from a diskette to a printer. 


For example, you can use PIP to: 


© Copy file(s) from one diskette to another diskette 

e Print file(s) on a printer 

* Copy file(s) from one user number to another user number 
* Combine two or more files into one file 

e Rename a file after copying it 


Do not use PIP to copy nontext files to a printer, 


Forms 
PIP has two modes: 


1, Command Mode. Use this mode for simple copying that can be typed 
on one line. This mode has several forms shown on the next page. The 
symbol [p] represents an optional parameter that is an additional 
instruction for PIP. (Refer to Table 7, found later in this section, for a 
list of the PIP parameters.) 


© Make a copy of a file and give it a new file name: 


PIP (Cory: Inewname. typ*(drvi Toldname. typi p) Cham) 


NOTE 

Unlike other options shown in brackets, [ ], when 
you use a PIP parameter, [p], you must include 
the brackets with the parameter. 
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© Copy an existing file to a new file, but keep the old file name: 


PIP drv:={drv:Joldname.typlp] Caaum) 
© Create a new file by combining two existing files: 


PIP Cdrv:}newname. typ=[drv: Joldnamet.typ[p], 
Cdrv: Joldname2. typ{p) CReum) 


NOTE 
If you specify a drive for oldnamel, you must also 
specify the drive for oldname2. 
¢ Copy data from a device to a file: 
PIP Cdrv:iname. typ-dev:(p) Chowm) 
© Copy a file to a device: 
PIP dev:=[drv: name. typlp) CGRewm) 


© Copy data from one device to another: 


PIP devi:=dev2: Cp] Giaum) 


The form of the PIP command you will probably use most often is: 


PIP drvieCdrv:loldname.typlp] CRewm) 
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2. Program Mode. Use this mode for more complex copying that 
requires more than one command to copy all the needed files. 
Program mode eliminates the need to type PIP with each command. 
To enter program mode, type: 


PLP Gao) 
PIP displays its prompt: 


CP/M-86 PIP VERSION 1.1 


* 


The forms of the PIP command in program mode are identical to 
those in command mode. However, in program mode, you do not type 
the command “PIP” on each line. 


Pressing the Return key or typing Ctrl/C next to the PIP prompt, *, 
returns you to the operating system prompt. 


Instructions 
For most forms of the PIP command, type the command followed by: 


1. The new file specification, which includes the device, file name, and 
file type. The new file specification is also referred to as the destina- 
tion file specification (where data is copied to). You type this informa- 
tion on the left side of the equal sign. 


2, An equal sign. 


3. The old file specification, which includes the device, file name, and file 
type. The old file specification is also referred to as the source file 
specification (where the data is copied from). You type this information 
on the right side of the equal sign. 


If you omit the device, PIP assumes the active drive. PIP accepts 
wildcards in file names and file types. 


96 


PIP 


4, Any optional parameters, When using parameters, follow the instruc- 
tions below: 


e Type parameters at the end of the command line inside square 
brackets, | |. 


© Do not include a blank space between the file specification and the 
opening bracket, 


e If desired, insert more than one parameter within the same square 
bracket. 


¢ Do not include a blank space between a parameter and its numeric 
value. 


e End parameters requiring a character sequence by typing Ctrl/Z. 


PIP ignores any invalid parameter(s) you type within the square 
brackets; the command is executed as though the invalid parame- 
ter(s) did not exist. 


Optional Parameters. Table 7 lists the optional PIP parameters and 
their effects. PIP parameters are single characters (or single characters 
followed by numbers or characters that supply information for the parame- 
ter to act on), In Table 7, “n” represents a numeric value and “s” repre- 
sents a character sequence you supply in the command line. Tell PIP you 
are finished typing the sequence by typing Ctrl/Z. More than one parameter 
can be used in the same command line in the form: 


Cppp-..3 
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Table 7. PIP Optional Parameters 


Parameter 


Effect 


Dn 


cod 


ox 


oe 


& 


Qs *Z 


yr 
> 
N 


Deletes characters that extend past column n (counted from the 
last Return or line feed). 


Echos (displays) all copying operations on the screen as they 
occur. 


Removes form feeds (page breaks) from the original file. 


Copies a file to or from a user number other than the currently 
active user number, This is the only parameter allowed to follow 
the destination file specification. When using G, you must specify 
the full file specification including the drive name. 


Transfers Intel hexadecimal data. 


Ignores null records (records that begin with :00) in the transfer 
of Intel hexadecimal file format. Automatically sets the H option. 


Converts uppercase characters to lowercase characters. This op- 
tion works with ASCII characters only. 


Adds line numbers to each line of the destination file. 
Transfers nontext files. 
Inserts a page break after each n lines. 


Copies from the first character (or where the S option is used) 
of the source file including the string you specified in s. Program 
mode must be used if lowercase characters are to be matched. 
Can be used with the S”option to extract a portion of a file. You 
can only specify one string. 


Copies files having the System Attribute. 


Copies from the string you specified in s of the source file to the 
end of the file (or where the Q option is used). Program mode 
must be used if lowercase characters are to be matched. Can be 
used with the Q option to extract a portion of a file. You can 
only specify one string. 


Sets tabs at every nth column. 


Converts lowercase characters to uppercase characters. This op- 
tion works with ASCII characters only. 


Verifies that data has been copied correctly. 
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Table 7. PIP Optional Parameters (cont.) 


Parameter Effect 


<= 


Writes over files with the Read Only Attribute. 


N 


Sets the parity bit to 0. When transferring ASCII files, use this 
option to set the eighth bit (bit 7) of each character to zero. Do 
not use this option with files containing non-English language 
characters, 


Checking For Free Space. Before using PIP, you should use the 
MAINT or STAT commands to check that the destination device has 
enough free space so the file can be copied. Check the space even if the file 
you are copying overwrites an existing file. If there is not enough free 
space on the destination device, PIP displays the following message: 


ERROR: DISKETTE WRITE - Edrv:lfilename.typ 


Avoiding Accidental Deletion. Use PIP with caution when copying 
files having identical file names and file types (but containing different data) 
between devices, Because PIP deletes the old file after copying the new 
file, you can accidentally delete a file if the files have the same name and 
type. 


For example, suppose you want to copy the file that contains survey results 
(SURVEY.TXT) from the diskette in drive A to the diskette in drive B. 
However, a file that contains survey questions (SURVEY.TXT) already 
exists on the diskette in drive B. 


When you copy SURVEY.TXT from the drive A diskette to the drive B 
diskette, PIP deletes the original SURVEY.TXT (containing the survey 
questions) from the drive B diskette. You now have two copies of the file 
containing survey results. Refer to Figures 7 and 8, 


PIP 


DISKETTE A DISKETTE B 
SURVEY.TXT SURVEY.TXT 


The XYZ Company How many Rainbow 

uses 45 Rainbow computers does 

computers. the XYZ Company 
use? 


MR-11070 


Figure 7. Status of Diskettes Before PIP 


DISKETTE A DISKETTE B 
SURVEY.TXT SURVEY.TXT 


The XYZ Company The XYZ Company 
uses 45 Rainbow uses 45 Rainbow 
computers. computers. 


MR-11071 


Figure 8. Status of Diskettes After PIP 
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To avoid accidental deletion of files, give each file a different file name and 
file type. 


Examples 

The following examples assume drive A is the active drive. If you omit the 
drive name, PIP assumes the active drive. However, you may include the 
active drive name if desired. 

For example, you can make a copy of the existing file, TEST. TXT on 
diskette A with a new name, NEW,TXT on diskette A using any of the 
following forms: 

A>PIP A:NEW.TXT=A:TEST. TXT Cieum) 

A>PIP A:NEW.TXT=TEST. TXT CReum) 

A>PIP NEW. TXT=A: TEST. TXT Chew) 

A>PIP NEW. TXT=TEST. TXT Ciewm) 


You now have two copies of the same file, but the files have different file 
names, 


The following examples omit the active drive name. 


1. Copy the existing file TEST.TXT on the diskette in drive A to the file 
EXAM.TXT on the diskette in drive B: 


APIP BsEXAM, TXT=TEST.TXT CRemm 


This form is considered the long form because you type file names and 
file types for the destination and source file specifications. 
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2. 
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Copy the existing file TRANSFER.SUB on the diskette in drive A to 
the same file name on the diskette in drive B: 


A>PIP B:=TRANSFER. SUB (Raum ) 


This form is considered the short form because you type only a device 
for either the source or destination file specifications, PIP replaces the * 
omitted file name and file type with the file name and file type 

specified in the source file specification. You cannot use this form to 
copy a file from a drive and user number to the same drive and user 
number. 


Copy the existing file NAMES.DOC on the diskette in drive A, user 
number 0, to the same diskette, user number 2: 


A>PIP Ar:[G21=NAMES.DOC CHeum) 


When using the [Gn| option, you must type the drive name in the 
destination file specification, Remember that the [Gn] option is the 
only option allowed as part of the destination file specification. 


Copy all files with the file type .TXT on the diskette in drive A to the 
diskette in drive B using a wildcard: 


AsPIP B:=*.TXT Claw) 


When you copy multiple files, PIP displays the file name of each 
successfully copied file. 


NOTE 
You can use wildcards only with the source file 
specification. 


Create a new file, NEWFILE.TXT on the diskette in drive B from two 
existing files (OLDFILE1.TXT and OLDFILE2.TXT) on the diskette in 
drive A: 


A>PIP B:NEWFILE, TXT=OLDFILE1, TXT, OLDFILE2. TXT Crowm ) 


PIP 


Separate the existing files with commas; you can enter blank spaces 
between the comma and the next file name. You can use parameters 
for each source file specification. The file NEWFILE.TXT contains the 
two existing files, OLDFILE1.TXT and OLDFILE2.TXT. 


. Extract a portion of the existing file WORDS.TXT on the diskette in 
drive A and copy it to the file LETTERS.TXT on the diskette in drive 
B. Begin extracting text with the word “NOW” and end with the word 
“LETTER”: 


ASPIP B:LETTERS.TXT=WORDS.TXT(SNOW*Z GLETTER®Z] CReum 


The words ‘‘NOW” and “LETTER” are included in the extracted 
portion of the file. If you want to match lowercase characters, use 
program mode. 


. Print the file REPORT.TXT on the printer: 
A>PIP PRN:*REPORT. TXT Geum) 


PRN: is a symbol used by PIP to output data to the printer device 
(LST:) in a special format that: 


© Numbers lines 
© Expands tabs 
e Paginates after 60 lines unless you use the [Pn] option 


The following command also prints the file on the printer, but does not 
number lines, expand tabs, or paginate: 


AsPIP LST: =REPORT.TXT Chewm) 
NOTE 


Refer to the Rainbow Installation Guide if you 
want to attach a printer to the computer. 


103 


PIP 
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Using program mode, create a new file NEWFILE.TXT on the 
diskette in drive A from the existing files OLDFILE1.TXT and 
OLDFILE2.TXT on the diskette in drive A. Then, copy the existing 
file NEWFILE.TXT on diskette A to diskette B: 


A>PIP Cistum) 

CP/M-86 PIP VERSION 1.1 
*NEWFILE=OLDFILE1. TXT, OLDFILE2. TXT Caemm) 
*B;=NEWFILE, TXT Comm) 

* Cet) 


The asterisk (*) indicates that PIP is ready to accept commands. Do 
not type the command PIP while using program mode, To exit PIP 
program mode, press the Return key or type Ctrl/C next to the PIP 
prompt, *, 
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Purpose 


RED is a transient command that calls in the Rainbow editor. You can use 
RED to create new files or make changes to existing files. 


Form 


RED [drv:}filename.typ 


Instructions 

Be sure the diskette is not write-protected. Type the command followed by 
the optional drive name, the file name, and the file type. If you omit the 
drive name, RED assumes the active drive. When you type the command, 
RED responds with: 


Loading RAINBOW EDITOR Version 1.1 


Examples 
The following examples assume drive A is the active drive. 
1. Create the file MEMO.TXT: 
A> RED MEMO. TXT Crewe) 
2. Create the file LETTER.DOC on drive B: 


A> RED B:LETTER, DOC 


NOTE 
For a complete description of RED, refer to 
Chapter 3 of this guide. 
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Purpose 
REN (rename) is a built-in command that changes the name of a file on a 


diskette to a new name on the same diskette. After you rename a file, the 
operating system no longer recognizes the file by its old file name. 


Form 


REN [drv:|newname.typ=[drv:Joldname.typ 


Instructions 
Type the command followed by: 


Optional drive name 

New file name and file type 
Equal sign 

Optional drive name 


S71) Fen Ue BSE 


Old file name and file type 


Any time you do not specify the drive name, the file is assumed to be on 
the active drive. 


You must type the old file name exactly as it is displayed in the directory. 
If you omit the drive name, REN assumes the active drive and does not 
accept wildcards in the file name or file type. If you include drive names for 
both files, the drive names must be the same. Verify the name change by 
using DIR. 
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Examples 
The following examples assume drive A is the active drive. 
\_ 1, Rename the old file ORIGINAL.TXT to the new file REVISED.TXT: 
A>REN REVISED. TXT=ORIGINAL.TXT Choum) 


2. Rename the old file ORIGINAL.TXT (on the diskette in drive B) to 
the new file REVISED.TXT (on the diskette in drive B): 


ADREN B:REVISED, TXT=ORIGINAL. TXT Chem) 
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Purpose 


STAT (status) is a transient command that displays information about files 
and devices. It also allows you to have certain controls over the files and 
devices. 


Different forms of the STAT command let you: 


© Display the status of a drive 

* Display free space on a diskette(s) 

© Display file size 

e Display and change the attributes of a file 

* Display STAT commands and device names 

© Display and set physical-to-logical device assignments 

e Display diskette characteristics 

* Assign a temporary Read Only Attribute to a drive 
The following discussion about the STAT command is divided into two 
parts: 

* How to use STAT with files 

* How to use STAT with devices 


Status of Files 


STAT provides the following levels of information about files and the dis- 
kettes they are stored on: 


STAT [drv:] Displays the amount of free space remaining on a diskette 
and the drive's attribute. 
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STAT filespec Displays the following information: 
Drive: indicates the drive the file is stored on. 


User: indicates the user number and the files stored 
under the current user number. 


Recs: indicates the number of records used by each file 
(each record is 128 bytes). 


Bytes: indicates the number of kilobytes used by each file. 


FCBs: indicates the number of File Control Blocks used 
by each file; a file control block contains the information 
necessary for the operating system to access the file, 
such as the file name, file type, file size. 


Attributes: indicates the attributes of the file; RO (Read 
Only) or RW (Read Write) and Dir (Directory) or Sys 
(System) are displayed under this heading. 


Name: indicates the name of the file. 


When you type a command that causes more than one file to be displayed, 
— STAT lists the files alphabetically, 


Forms 


¢ Display the attributes and amount of free space (in bytes) on the dis- 
kettes in ail drives accessed since the last operating system start-up: 


STAT CRetwn ) 
* Display the amount of free space (in bytes) on a specified diskette: 


STAT dev: 


® Display the size (in records and bytes), file control blocks, and 
attributes of a single file or group of files: 


STAT Cdrv:Jfilename. typ Chawm) 
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* Assign an attribute to a single file or a group of files: 


STAT Cdrvilfilename.typ atr Geum) 
or 

STAT [drv:)filename. typ Satr Glew) 
or 

STAT Cdrv:lfilename.typ Catr] Gawm) 
or 


STAT Cdrv: filename. typ=latr} Geum) 


Instructions 


Type the command followed by the optional drive name, file name, file 
type, and any optional attributes, If you omit the drive name, STAT 
assumes the active drive. STAT accepts wildcards. 


When assigning attributes to files, separate the file specification from the 
attribute with a blank space, a comma, or an equal sign (=) known as a 
“separator.” If desired, you can precede the attribute with a dollar sign ($) 
or enclose the attribute in square brackets ([ |). Attributes are RO, RW, 
Sys, and Dir, 


Examples 


The responses for the following examples may not be displayed exactly as 

shown in these examples, because your diskette probably contains different 
files, For example, the free space remaining on your diskette will probably 
be different from the values in the examples shown. The examples assume 
that drive A is the active drive: 


1, Display the attributes and amount of free space on the diskettes in 
drive A and drive B, both of which haye been accessed since the last 
operating system start-up. 


A>STAT Chew ) 
A: Ri, Free Space: 180k 
B: RW, Free Space: 176k 
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Display the attributes, file control blocks, and amount of space 
occupied by the file SHOW.SUB on the diskette in drive B: 


A>STAT B:SHOW. SUB Cieiwm) 


Drive B: User : 0 
Recs Bytes FCBs Attributes Name 

1 2k 1 Dir RW B: SHOW + SUB 
Total: 2k 1 
B: RW, Free Space: 230k 


Display the attributes, file control blocks, and amount of space 
occupied by each file with the file type .TXT: 


ADSTAT *.TXT Gam) 


Drive A: User : 0 
Recs Bytes FCBs Attributes Name 
1 2k 1 Dir RW A:DOCU «TXT 
1 2k 1 Dir RW A:SHOW «TXT 


Total: 4k 2 
A: RW, Free Space: 230k 
Assign the System Attribute to the file TEST. TXT: 


A>STAT TEST.TXT SYS Gum) 
A: TEST «TXT set to System (Sys) 


Assign the Read Only Attribute to the file SHOW.SUB: 


A>STAT SHOW.SUB RO Cieum) 
A: SHOW SUB set to Read Only (RO? 


STAT 
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Status of Devices 
The computer routinely communicates with the following devices: 


¢ Video display device: the screen 
® Keyboard 


© Drives 


In addition, the computer can communicate with other devices ‘that you 
connect to it, such as: 


© Printers 


* Modems (a device used to communicate with a computer over phone 
lines) 


* Other computers 


The operating system needs to know which devices are connected to the 
computer so the computer can operate properly. You tell the operating 
system which devices are connected to the computer when you assign logi- 
cal names to physical devices, such as a printer. 


Logical names are used because any one of several “physical” devices can 
be connected to the computer to accomplish one function, For example, the 
logical name CON: (console) represents your console input/output device 
whether it is a CRT: (video terminal) or a TTY: (teletype). 


Logical names are assigned to physical devices through the STAT 
command, 


Standard assignments are made before you receive the computer. You 
should not have to change these unless you want to make different 
assignments, 


Table 8 lists logical names and their generic representations. 
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Table 8. Rainbow Computer's Logical Name Assignments 


Logical Name Function 


CON: This is the user console device. It interacts with the 
operating system, accepts input from a keyboard and 
displays output on either a video screen or on paper. 


AXI: This device receives information (input only). 
AXO: This device sends information (output only). 
LST: This device lists information (output only), on a printer, 


for example. 
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STAT associates these logical names with one of several standardized phys- 
ical device names, Table 9 lists the meanings of these physical device 
names for the computer, The term port in Table 9 refers to an input or 
output connection to the computer. You can assign any one of the physical 
devices to each logical device. 


Table 9. Rainbow Computer's Physical Name Assignments 


Physical Device Name Physical Device 
TTY: The printer port that allows input and output 
CRT: A video terminal (the video screen and keyboard) 
BAT: The communications port, input and output 
UCI: The optional communications port 
PTR: The communications port, input only 
PTP; The communications port, output only 
URI: The optional communications port 
UR2: A null device 
UPI: The optional communications port 
UP2; A null device 
LPT: The communications port, input and output 
ULI: ‘The optional communications port 

NOTE 


The console is set up to be the keyboard/monitor; 
the commport to be the I/O device; and the 
printer port to be the listing device. 
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Forms 
1, Display the current physical-to-logical device assignments: 
STAT DEV: 


2. Display the possible physical-to-logical device assignments and a partial 
STAT command summary: 


STAT VAL: 

3. Assign a physical device (phydev:) to a logical device (logdev:): 
STAT logdev:=phydev: CRewm) 

4. Display diskette storage characteristics: 
STAT Edrv:IDSK: 


This form of STAT displays useful information for advanced users of 
the CP/M-86/80 operating system. 


5. Assign a temporary Read Only Attribute to a drive: 
STAT drv:=RO (Rewm) 
You can set the drive back to the Read Write Attribute by using the 


STAT command, typing Ctrl/C, or turning the computer off. The 
operating system sets drives to the Read Write Attribute by default. 


6. Display the current user number and all user numbers that contain 
files: 


STAT USR: 
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Instructions 


Type the command followed by any desired parameters. If you omit the 
drive name, STAT assumes the active drive. 


Examples 
1. Display the current physical-to-logical assignments: 


AsSTAT DEV: Chewm) 
CON: is CRT: 
AXI: is PTR: 
AXO: is PTP: 
LST: is TTY: 


2, Display a partial STAT command summary and the valid physical-to- 
logical device assignments: 


AsSTAT VAL: Gavum) 

STAT 2.2 

Read Only diskette: d:=RO 

Set Attribute: d:filename.typ Cro] {rw] (sys} or (dir) 
diskette Status : DSK: d:DSK: 

User Status : USR: d:USR: 

lobyte Assign: 


CON: = TTY: : BAT: UC1: 
AXI: = TTY: UR1: UR2: 
AXO: = TTY: UP1: UP2: 


LST: = TTY: CRT: LPT: UL1: 
3. Assign the logical name CON: to the physical device CRT: 


A>STAT CON: CRT: 
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4, Display the characteristics for the diskette in drive A: 


AxSTAT A:DSK; Crewe 


Ar 
3,120: 
390: 
128: 
128: 
256: 
16: 
40: 
2: 


Drive Characteristics 

128 Byte Record Capacity 

Kilobyte Drive Capacity 

32 Byte Directory Entries 

Checked Directory Entries 

128 Byte Records / Directory Entry 
128 Byte Records / Block 

128 Byte Records / Track 

Reserved Tracks 


5. Set drive B temporarily to the Read Only Attribute: 


A>STAT B:*RO Ciewm) 


NOTE 


Using STAT to write-protect a diskette is 


probably not advisable because such protection is 
\ retained only in the computer and is nullified when 
you type Ctrl/C or turn the computer off. 


6. Display the active user and all user numbers that contain files: 


Ad STAT USR: Chewn 
A: Active User : 0 
A: Active Files: 0 


NOTE 


Refer to the discussion of the USER command to 


change user numbers. 
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Purpose 


SUBMIT is a transient command that runs a group of previously generated 
CP/M-86/80 commands from a file you create. Use SUBMIT if you: 


e Type the same series of commands repeatedly 
e Want to run complex tasks by using one command 


Forms 


SUBMIT filename Ciewm) 
SUBMIT filename parameters (Rem) 


The first form runs command files containing complete commands. The 
second form runs command files that require input from the keyboard. 


Instructions 


Create a command file with the file type SUB using a text editor such as 
RED (refer to Chapter 3 of this guide). Type the commands, each on a 
separate line, in the order you want them to be executed. (The .SUB file is 
sometimes referred to as a command file because it contains commands.) 
Then type the SUBMIT command followed by the file name containing the 
commands you want executed. You do not need to specify .SUB with the 
file name. SUBMIT automatically looks for that file type. 


When run, SUBMIT searches for the specified file name with the file type 
-SUB and creates a copy of this file named $$$.SUB on the diskette that is 
in the drive you started the operating system from. Because SUBMIT cre- 
ates a file on this diskette: 

© It cannot have a write-protect tab on its write-protect notch. 

e Free space must exist on the diskette. 
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The file, $$$.SUB, is a copy of the original file. The operating system 
sequentially executes each command you typed in that file. The operating 
system deletes each command line in $$$.SUB as it is executed and deletes 
the entire file when all the commands are executed. 


You can stop the SUBMIT program by pressing any key. When you do this, 
the operating system completes the current command before it stops the 
SUBMIT program. Because the program did not complete, the file still 
resides on the diskette. If you do not delete this file from the diskette 
before you reset or turn the computer off, the SUBMIT program attempts 
to continue with the commands remaining in the $$$.SUB file the next time 
you start the computer. 


Using Incomplete Commands 


If you want to specify different files, drives, or devices each time you run a 
.SUB file, create a file with incomplete commands. Mark the missing pieces 
of information with a dollar sign ($) followed by a number from one to nine, 
inclusive. SUBMIT allows nine such “place holders” in each .SUB file. The 
combination of these two characters serves as a place holder until you run 
SUBMIT and supply the information in the command tail. Use two dollar 
signs ($$) if you want to include a literal dollar sign in the .SUB file. 


Type the specific parameters at the end of the command when running 
SUBMIT. Type a blank space between each parameter. 


When SUBMIT runs the command file, all occurrences of $1 in the SUB 
file are replaced with the first parameter found in the command tail, All 
occurrences of $2 are replaced with the second parameter found in the 
command tail. The same procedure occurs for each place holder. 


SUBMIT ignores parameters supplied in the command tail that exceed the 
number of place holders in the .SUB file. If you do not supply enough 
parameters, SUBMIT removes the place holders from the .SUB file and 
executes the command without the information. This usually results in a 
problem. 
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You cannot nest SUBMIT commands within .SUB files. However, you can 
cause another .SUB file to execute from the previous .SUB file. Do this by 
including a SUBMIT command as the last line in the file; this “links” one 
-SUB file to another .SUB file. In Figure 9 the file XXX.SUB is linked to 
the file YYY.SUB. 


XXX,SUB YYY.SUB 


DIR * CMD STAT TEST.TXT 
RED TEST.TXT 
SUBMIT YYY. 


MR-11072 
Figure 9. Linking Two .SUB Files 


Wildcards can be used as part of the commands within a .SUB file. 
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Examples 


The following examples assume drive A is the active drive. 


1, 


Create a command file named SUBEX.SUB using the text editor, 
RED, containing the following complete commands; 


STAT 
RED TEST.TXT 
TYPE TEST-TXT 
STAT 


Next, type: 


ASUBMIT SUBEXA (Hewm ) 
When SUBMIT runs the commands in SUBEX.SUB: 


© STAT displays the amount of free space on the diskette in drive A, 

© The text editor, RED, creates a file named TEST.TXT. 

e You type the contents of the file and then return to the operating 
system. 

e TYPE displays the contents of TEXT.TXT after you exit the text 
editor. 


* STAT displays the amount of free space left on the drive A 
diskette. 


Create a command file named TRANSFER.SUB containing the 
following incomplete commands: 


PIP 82:*61:83.* 
STAT #2:43." 


SUBMIT substitutes the information that you type in the command tail 
for the place holders $1, $2, and $3 in the file. The colons and 
asterisks are literal additions that SUBMIT appends to that 
information. 
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Next, type: 
A>SUBMIT TRANSFER B A ACCOUNT CReum) 
When SUBMIT runs the commands in TRANSFER.SUB: 


© Bis substituted for all occurrences of $1. 

© A is substituted for all occurrences of $2. 

* ACCOUNT is substituted for all occurrences of $3. 
e Band A are separated by an equal sign (=). 

e An asterisk (*), is appended to ACCOUNT. 


The result of running TRANSFER.SUB is the same as typing the 
following commands: 


A>PIP A:*B:ACCOUNT.* CReum) 
A>STAT A: ACCOUNT. * CRewm ) 


Include necessary separators, such as periods, colons, and wildcards, in 
your .SUB file so you do not have to type them on the SUBMIT 
command line. Sometimes, separators included in a command line 
result in a problem. The following example causes a problem because 
the period between “TEST” and “DOC” can be intrepreted as a 
parameter separator rather than as a character in a single parameter. 


A>SUBMIT TASK TEST.DOC Crewm) 
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TYPE 


Purpose 


TYPE is a built-in command that displays the contents of a text file on the 
screen, Text files contain only printable characters. You cannot use TYPE 
with file types .COM, .CMD or .SYS. 


TYPE also displays files even if they: 


e Have the Read Only Attribute 
¢ Are stored on a diskette that has a write-protect tab on it 
* Reside in a drive that has the Read Only Attribute 


Form 


TYPE [drv:]filename.typ Gaetam) 


Instructions 


Type the command followed by the optional drive name, the file name, and 
the file type. If you omit the drive name, TYPE assumes the active drive. 
TYPE does not accept wildcards in the file name and file type. 


Press Hold Screen or type Ctrl/S to temporarily stop the text from scrol- 
ling; press Hold Screen or type Ctrl/S again to continue the display. Repeat 
this process to stop and start the display. Type Ctrl/C or any other key to 
stop the display and return to the operating system. 


Do not use the TYPE command on files with nontext characters such as file 
types .COM, .CMD, or .SYS. If you accidentally TYPE a nontext file, the 
screen can become garbled and the computer can stop. If this happens, 
reset the computer by pressing the Set-Up key followed by the Ctrl/Set-Up 
keys. 
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Examples 
The following examples assume drive A is the active drive. 
1. Display the contents of the file TEST.TXT: 
A>TYPE TEST. TXT CRewm) 
2. Display the contents of the file TEST.TXT on the diskette in drive B: 


ADTYPE B: TEST. TXT Gaewm) 
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USER 


Purpose 

USER is a built-in command that displays or changes the current user 
number. User numbers refer to unique areas on a diskette that separate 
files into groups of alternate directories, These alternate directories are 
useful when you want to separate types of files, for example, monthly 
reports in one directory and budget reports in another. Alternate directo- 
ries are also useful when you want to: 


* Store files for later use 
e Unclutter the main directory 


The default user number is 0. 
The operating system assigns the current user number to a file when: 


* You create a file 
* You copy a file from another user number 


Form 
USER [n] Grew) 


Instructions 


Type the command followed by an integer from 0 to 15, inclusive, to 
change the user number. If you type the command alone, the current user 
number is displayed. 


Most commands access only those files in the current user number. For 


example, while in user number 7, a DIR command displays only those files 
in user number 7, 


125 


USER 


Generally, files stored in user numbers are not accessible by other user 
numbers. PIP’s [Gn] option lets you copy a file from one user number to 
another. Also, assigning the System Attribute to a file allows all user num- 
bers to access that file. 


When you turn on or reset the computer, the user number is 0. The user 
number does not change when you reinitialize the operating system by 
typing Ctrl/C. 

If you change the user number, the new user number applies to all disk- 


ettes. For example, if you change from diskette A to diskette B, the user 
number remains the same. 


Examples 
The following examples assume drive A is the active drive. 


1, Display the current user number: 


A> USER Cheum) 
2, Change the current user number to 3: 


A>USER 3 Giemm) 
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Creating and Changing a 
Document 


What is an Editor? 


In Chapter 1, you were introduced to the CP/M-86/80 text editor, RED. An 
editor is used to create new documents such as reports, memos, letters, or 
to make changes to an existing document. RED is a screen-oriented editor 
that displays a screen of text at a time. 


What is in This Chapter? 


This chapter describes commands to create as well as edit (make changes 
to) a file. In this chapter, the command descriptions are divided into two 
sections according to the following categories: 


Section 1; Basic Commands 


1. Starting an editing session 
2. Typing a document 

3. Looking at a document 

4. Changing a document 
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5. Getting help 
6. Ending work with a document 


7. Printing a document 
Section 2: Advanced Commands 


1. Using more advanced commands that allow you to move text within a 
document as well as combine two documents. 


Commands and Keys to Use 
with RED 


While using RED, you type commands and press special editing keys to 
perform certain tasks, Table 10 is an alphabetical list of all RED commands 
and the meaning of each. Table 11 is a list of the special editing keys and 
the task each one performs (the tasks are called functions). 


RED Commands 


You use any of the following commands after you type RED to enter the 
editor program. 


Table 10. RED Commands 


Command Meaning 

Append Allows you to see a directory list of documents, or add 
one document to the end of another. 

Copy Copies a section of text from one part of a document to 
another part of the same document. 

Display Displays either the next or previous screen of a docu- 
ment. 

Erase Erases spaces, character(s) or lines from a document. 

Goto Moves the cursor to the top or bottom of a document, 
to a specific line, or to any preset pointer within a 
document. 
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Creating and Changing a Document 


Command 


Output 


Pointer 


Quit 
Replace 
Tab 


View 


Write 


Meaning 


Summarizes RED commands and includes tips on how 
to use them. 


Allows you to add text to a document. 


Searches for any character, word, or symbol within a 
document. 


Moves a section of text from one part of a document to 
another part of the same document. 


Displays, one at a time, the three RED command lines 
at the top of the screen. 


Instructs the printer to print a section of a document. 


Allows you to mark sections of text for moving, copy- 
ing, deleting, or printing, 


Ends your work on a document. 
Finds and replaces characters in a document. 
Shows you where tabs have been set in RED. 


Allows you to look at one document while editing an- 
other. 


Creates a new document from sections of an existing 
document, 


Deletes and replaces any specified character in a docu- 
ment. 


Deletes sections of a document. 
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RED Editing Keys. 


The special editing keys are shown in Figure 10. Table 11 lists the function 
of these keys. 


Figure 10. RED Special Editing Keys 
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Note from the descriptions in Table 11, that several of the special editing 
keys perform the same tasks as some of the commands. 


Table 11. Special Editing Key Functions 


— 
Key Function 
Do Instructs RED to execute or cancel a command. 
Delete character Deletes a single character to the left of the cursor only 
while you are inserting text. 
Return Instructs RED to execute a command. 
Help Displays information on each command; used alone or 
with a command key. 
Find Searches for any character, word, or symbol within a 
document; works the same as the Locate command. 
Insert Here Allows you to add text to a document; works the same 
as the Insert command. 
Remove Erases spaces, character(s), or lines from a document; 
works the same as the Erase command, 
7 Select For future use. 
Prev Screen Displays the previous screen of a document; works the 
same as the -D (Display) command. 
Next Screen Displays the next screen of a document; works the 
same as the D (Display) command. 
Directional Move the cursor within the text: 
arrow keys: 
Up arrow(#) Moves the cursor up one line at a time. 
Down arrow(#) Moves the cursor down one line at a time. 
Right arrow(™) Moves the cursor right one character at a time. 
Left arrow(#) Moves the cursor left one character at a time. 


13] 


Creating and Changing a Document 


Section 1 
Using Basic Editing Commands 


Starting an Editing Session 


It is assumed that you have turned on the computer and have started the 
CP/M-86/80 operating system in drive A. 


First, you must create a new document called a file. Follow the same guide- 
lines for naming files in RED as in naming CP/M-86/80 files. (Refer to 
Chapter 2 in this guide for more information about naming files.) 


To be sure you have enough space on the diskette for a new document, use 
a blank diskette. Insert the blank diskette into drive B. Then, type the RED 
command followed by the drive name and an unambiguous file name and file 
type. As an example for this exercise, next to the prompt, type: 


A>RED Bi MEMO. TXT (Roum 


NOTE 
Be sure to include the colon after the drive name. 


RED creates the file MEMO.TXT and displays the following statement: 
Loading RAINBOW EDITOR Version 1,1 


NOTE 
If the message: 


RED ERROR: Please enter “RED” followed by 
a file name 


is displayed on the screen, you either made an 

error while typing the file name, or you omitted 

the file name. Type the file name again exactly as 
indicated above. Be sure to use a valid CP/M-86/80 
file name. You cannot use file types $$0, $$1, $$2 
because RED reserves these for specific types of files. 
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Header at the Top of the Screen 


After you create the file name, RED displays three lines at the top of the 
screen as shown in Screen 19, 


DRED: Insert Erase Pointer Goto Locate Replace Display Quit Next 

Document: B:MEMO, TXT Char: 1 Lines 1 
[Oe R 
1 


Screen 19. RED Header Lines 


These lines are: 


e The command line: the first line 
© The status line: the second line 
© The broken line: the third line 
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The Command Line 
The command line displays 
>RED: Insert Erase Pointer Goto Locate Replace Display Quit Next 


listing the editing commands you can use while using RED. The first char- 
acter of each command is displayed in bold face. This means that you only 
need to type the first character of that command. 


There are more commands than RED can display on one line. Therefore, 
the commands are separated into three different lines, which are displayed 
one at a time at your request. To display each of the other two lines, use 
the Next command (N). The Next command is listed at the end of each 
command line. Each time you type N, the next line of commands is dis- 
played. If you are looking at the third line and type N, the first command 
line is redisplayed, Even if an editing command is not displayed, you can 
still use that command by typing the first letter of the command. 


NOTE 

The sample screens in this guide display the first 
line of commands except where it is inappropriate. 
If you have used the Next command, the top line 
displayed on your screen may not match the 
screens in this text. 
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The Status Line 

The Status Line displays 

Document: drv:filename.typ Char: n Line: on 

On the far left is the drive name and file name. To the far right are 
“Char:” followed by a number, and “‘Line;” followed by a number. These 
tell you how many characters and lines you have typed, or the number of 
the character and line you are changing. Each count is 1 before you begin. 
The numbers change as you type new text, or move the cursor through the 
existing text. They also provide useful information for moving the cursor 


around with such commands as Goto, Locate, and Tab discussed later in 
this chapter. 


The Broken Line 


The broken line displays 


showing the left and right margins. This line separates the command and 
status lines from the text you enter. The cursor is displayed just below the 
broken line. As you enter text, the cursor moves to the right. 


Typing a Document 


To enter text into a document, use the Insert command (1) or the Insert 
Here key located on the keypad. (Refer to Figure 10,) Press: 


or 


Cinvon Fore) 
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The command line of the screen changes and RED instructs you to enter 
the text and press the Do key when finished: 


>INSERT: Enter text, then 


NOTE 

Remember to type only the first character of a 
command. If you type additional characters, RED 
accepts them as part of the text you want to 
insert. You can erase them by using the delete 
character key. 


Type the following memo that is printed in color. Type everything exactly 
as you see it. Be sure to press the Return key and the Do key where 
indicated. The memo contains errors for you to change later. 


To the staff; (Return ) 


(CRewm_) 
There will be o staff meeting today Gewn) 


in the floor Mayflower Conference (few) 
Room at 2:00 P.M. noon, Chem) (eum) 
Do) 


See Screen 20 for the entire dialog. 
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INSERT: Enter Text, then ¢D0> 
Document: B:MEMO. TXT Char: 1 Line: 5 


To the staff 
« 

There will be a staff meeting today< 
in the floor Mayflower Conferencec 
Room at 2:00 P.M. noon.¢ 

' 


« 


Screen 20. Inserting Text 


When you finish inserting the memo and then press the Do key, the top 
line of the screen returns to the command line. The cursor is displayed 
below the last line of the memo. 
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Using Tab 


When entering spaces in text, you can use either the space bar or the Tab 
key. 


You cannot change tab settings in RED; they are always set at every eight 
character positions: 1, 9, 17, 25, 33, 41, 49, 57, 65 and 73. The Tab 
command (T) shows you where tabs have been set. Type: 


T 


RED displays the tab locations. (See Screen 21a.) 


TABS are set as shown below, press ¢RET> to continue. 


1 2 3 4 s 6 7 8 
1234567890 1234567690 1234567890 1234567890 1234567890 1234567890 1234567890 1234567890 
a | T T T ¥ T T T T T 


Screen 21a. Tab Command 


Pressing the Return key returns you to the command line and the text. 
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If the cursor is positioned at the beginning of the first line of the document 
and you press the Tab key, the cursor moves across the first line to the 
“t” in “staff;’. The character count increases to 9. (See Screen 21b,) In 
other words, if you press a Tab to space over existing text, RED counts 
the individual characters, 


RED: Append View Achng Tab Help Next 
Document: B:MEMO.TxT Char: 9 Line: 3 


To the sfatf 
« 

There will be @ staff meeting todaye 

in the first floor Mayflower Conferencec 
Room at 2:00 P.m.« 

« 


Screen 21b. Using the Tab Key 
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However, if you insert a tab to indent the first line, RED counts the tab as 
one character and changes the character count to 2 as shown in Screen 
21c. 


rc 


RED: Append View Xchng Tab Help Next 
Document: B:MEMa, TXT Char: 2 Line: 1 


Ib the starts« 
‘ 

There vill be w staff meeting todays 

im the firat floor Mayflower Conferencee 
Room at 2:00 P.m.e 

‘ 


Screen 21c. Inserting a Tab 


Looking at a Document 


The Display command (D), Next Screen Key and Prev Screen key are all 
useful when you have more than one screen (twenty-one lines) of text. 
These keys allow you to display a screen of text at a time, moving either 
forward or backward through the document. 
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Moving Forward and Backward 


To move forward one screen, type: 


D 


or press the Next Screen key. To move backward one screen, type: 


Do 


or press the Prev Screen key. If you want to skip several screens ahead or 
behind, type a number in front of the D (or Next Screen key), or the -D (or 
Prey Screen key). For example, 3-D causes RED to display the third screen 
previous to the current one. If you have only one screen, as you do with 
MEMO.TXT, and the cursor is at the top of the document, the following 
occurs; 


1, 


Pressing D or the Next Screen key causes the text to disappear from 
view. You do not lose the text, however. 


Pressing -D or the Prev Screen key redisplays the document and 
reverses the angle bracket, at the beginning of the command line, to 
<. This indicates the direction of the cursor. If the cursor is moving in 
a backward direction, the command line begins with “<RED:”. If the 
cursor is moving in a forward direction, the command line begins with 
“SRED;”, 


If the cursor is at the bottom of MEMO.TXT, the following occurs: 


Pressing D or the Next Screen key redisplays the document. 


Pressing -D redisplays the document moving the cursor to the top and 
changing the angle bracket pointing left (<). 


Pressing the Prev Screen key redisplays the document, and reverses 
the angle bracket, at the beginning of the command line, to >. 
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Changing Text 


To make changes in the document, you must first know how to moye the 
cursor within that document. 


Keys to Move the Cursor 


Table 12 lists the keys you can use to move the cursor. The letter n 
represents a number you type if you want to move the cursor more than 
one line or character at a time. You press the number first, then the 
desired key. 


NOTE 

You cannot use the cursor keys while you are 
inserting text; you can only use them while you 
are changing text. 


Table 12. Keys to Move the Cursor 


Key Action 


Moves the cursor to the “nth” character position using 
the left, right, up, and down arrow keys. If you do not 
specify a number, the cursor moves one character or 


one line. 

nPunctuation Moves the cursor to the “nth” occurrence of the fol- 
lowing characters: comma, period, at sign (@). 

a Moves the cursor to the first character of the line 
following the “nth” carriage return. 

nSpace bar Moves the cursor to the “nth” space between 
characters. 


Moves the cursor to the “‘nth” tab location in text. For 
example, 2Tab moves the cursor two tab stops ahead 
of its current position; -2Tab moves the cursor two tab 
stops before its current position. 
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Cursor Direction 

Pressing the left angle bracket key (<) or the minus sign key (-), causes the 
cursor to work back toward the beginning of the document. Holding down 
the Shift key while pressing the right angle bracket key (Shift/>) or holding 


down the Shift key while pressing the plus sign key (Shift/+) causes the 
cursor to work forward toward the end of the document. 


Adding Text 

The Insert command (1) and the Insert Here key can both be used to insert 
text into an existing document. Move the cursor, using the arrow keys, to 
the “f” in the word “floor”. Type: 

1 


or 


(Ciisent ere) 
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The existing text drops two lines to open a space for you to type additional 
text. The cursor position does not change and the new text is inserted 
before the cursor. (See Screen 22a.) 


INSERT: Enter text, then «DO» 
Document: B:MEMO. TXT Char: @ Line: 4 


———— 
To the staff:¢ 
« 


There will be a staff meeting todaye 
in thell 


floor Mayflower Conference 
Room at 2:00 P.M. noon.¢ 
« 


Screen 22a. Adding Text 


Notice that the command line changes. RED instructs you to enter the text 
and press the Do key when finished. Type the text next to the cursor, 
Remember to type a space after you have finished adding the text; 
otherwise, two words will run together. 


Type: 
first Ga) 
After you press the Do key, the text merges and RED redisplays the 


command line, (See Screen 22b.) RED positions the cursor on the “f”’ in 
the word “floor”. 


144 


Creating and Changing a Document 


DRED: Insert Erase Pointer Goto Locate Replace Display Quit Next 
Document: B:MEMO. TXT Char: 14 Lines 4 


To the staffic 

‘ 

Thera will bee staf meeting todaye 

in the first Bloor Meyflover Conferenceé 
Room et 2:00 P.M, noon, < 

é 


Screen 22b. Added Text 


Erasing Text 


The Erase command (E), or the Remove key, removes spaces, character(s), 
or lines from a document. For this example, move the cursor to the space 
before the word “‘today"’. Then, press: 


or 
Gamo) 


RED instructs you to move the cursor across the text you want to erase 
and press the Do key when finished. 
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Move the cursor to the carriage return symbol (<). When you move the 
cursor forward, text to be erased is displayed at half the intensity. 
This is known as ‘‘marking” a section of the document. 


Va 
DERASE: Move cursor, then ¢DO> 
Document: B:MEMO.TAT Char: 36 Line: 3 
To the staffr« 
< 
There will be @ staff meeting today| 
in the first floor Mayflower Conferencee 
Room at 2:00 P.m.< 
« 
Screen 23a. Erasing Text 
NOTE 
If you change your mind or erase too far, reverse 
the cursor, using the left arrow key, over the 
character(s) you want to keep. Remember, only 
the characters shown in half-intensity will be 
erased. 
Now press: 
(ers) 


RED erases the space and the word “‘today’’. It then redisplays the 
command line. 
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Now move the cursor to the space before the word ‘“‘noon’”’. 


1. Press: 


2. Move the cursor to the carriage return symbol 


Press: 


Ge 


RED erases the space, the word “noon”, and the period. (See Screen 23b 
for the results of the entire procedure.) 


« 


« 


DRED: Insert Erase Pointer Goto Locate Replace Display Quit Next 
Document : 


To the staff: 


There will be a staff meeting todaye 
in the first floor Mayflower Conferences 
Room at 2:00 P.m.§ 


Char: 18 Lines 5 


Screen 23b. Erased Text 
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Exchanging Characters 


The Xchng command (X) exchanges or replaces characters or words, char- 
acter-by-character. Move the cursor, using the arrow keys, to the “‘s”’ in 
the word “‘staff;”’ in the first line. Type: 


x 


In a new command line, RED instructs you to enter the new text and press 
the Do key when finished. This example changes the lowercase “‘'s” in 
“staff"’ to uppercase, and changes the semicolon after ‘staff; to a colon(:). 
Type: 


Staff: Go} 


NOTE 

You could also use the Xchng command twice to 
change the two characters individually. However, 
retyping the whole word reduces time and 
keystrokes. 


As you type the new characters, the old characters are exchanged. After 
you press the Do key, RED redisplays the command line and saves the 


correction. RED places the cursor on the carriage return symbol (<) at the 
end of the line ‘To the Staff: 


Replacing Text 

The Replace command (R) finds and replaces a word or character(s) each 
time it occurs in your document. Move the cursor to the beginning of your 
text and type: 


fp 


In a new command line, Red instructs you to enter the old text and press 
the Return key when finished. 
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The number 10000 is displayed to the left of the word “REPLACE” on the 
screen. This number indicates that Replace will find and replace up to 
10,000 occurrences (in other words, all occurrences) of the specified entry. 
For this example, change 2:00 P.M. to 10:00 A.M. Tuesday. Type: 
2:00 P.M. Chatum) 

NOTE 

It is important, when entering the text you want 

to replace, to type the text exactly as it was 

typed in your document. This includes using 

uppercase and lowercase characters where 

appropriate. To replace a word like “the’’ which 

may be part of “‘other’’, do the following: 

Type a space. 

Type the. 


Type another space. 


This ensures that RED will search for “the” only 
when it is a separate word. 


After you press the Return key, RED displays a new command line 
instructing you to enter the new text and press the Return key. 


Type: 


10:00 ALM. on Tuesdey. Greum) 
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RED displays the word Prompt in lower intensity. See Screen 24a for the 
entire dialog. 


10000 REPLACE: Enter old text, then «RET> 2:00 P.M. 
Enter new text, then «RET> 10:00 A.M, On Tuesday. Prompt <RETOM 


To the staffie 
« 

There will be @ staff meeting today¢ 

in the first floor Mayflower Conferencec 
Room at 2:00 P.M.« 

« 


Screen 24a. Replacing Text 


The prompt is there as insurance for you. Press the Return key again. RED 
stops at each occurrence of the word you want to replace and asks: 


29999 Replace with: "(new text)" Yes No 


In response, type: 


The number to the left of REPLACE has changed to indicate how many 
more occurrences of the text can be replaced. 


150 


Creating and Changing a Document 


There is now a blinking cursor on the 2 in “2:00”. RED is prompting to 
see if you want this word replaced, (See Screen 24b.) 


> 9999 REPLACE with: "10:00 A.M. on Tuesday." Yes No 


To the staffr< 


« 
There duit) besa catatt heatang tgeaye 

in the first floor Mayflower Conferences 
Room at §:00 P.m.« 

‘ 


Screen 24b. The Replace prompt 
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Type: 
v 


The old text is replaced with the new text. (See Screen 24c.) 


DRED: Insert Erase Pointer Goto Locate Replace Display Guit Next 
Cha 30 La 


There will be a staff meetinge 


in the first floor Mayflower Conferences 
Room at 10:00 A.M. on Tuesdayffc 
‘ 


Screen 24c. Replaced Text 


If this was not the last occurrence of the entry you wanted to replace, RED 
moves to the next occurrence. Otherwise, it redisplays the command line. 


You can decide not to use the prompt feature. If you want to turn the 
prompt off, press 


P 


before you press the Return key the second time. RED erases the word 
“Prompt” then when you press the Return key, RED automatically replaces 
the first occurrence of the old text. 
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> 1 REPLACE: Enter old text, then ¢RET> 2:00 P.M. 
Enter new text, then «RET? 10:00 A.M. on Tuesday. «RET? 


There will be a staff meetinge 
in the first floor Mayflower Conferencec 
Room at 2:00 P.M.¢ 


« 


Screen 24d. Replace with No Prompt 


If there is more than one occurrence of the old text and you wish to 
replace all occurrences, type the number sign (#) and press the Return key. 
If you want to replace only the first three consecutive occurrences of the 
entry, first type the number 3 and then press R. 
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Getting Help 


If you have forgotten the purpose of a command, ask RED for help, using 
the HELP command or the Help key. Type: 


H 
or 
Hel 


In a new command line, RED instructs you to press the first letter of the 
command you want help with. (See Screen 25a.) 


>HELP: Enter commandil 
Document: B:MEMO. TAT Char> 4 Lines 4 


To the staffre 
s 

There will be @ staff meetings 

in the first floor Mayflower Conferencec 
Room at 10:00 A.M. on Tuesday. < 

< 


Screen 25a. RED Help Screen 
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For this example, type: 


RED displays information about the HELP command. (See Screen 25b.) 


>Press any key to return to document 


« commanD: WELP 


WHAT IT DOES: Explains how to use any RED command. 


HERES HOW: 1. Type “HY of <HELP. 
2. Type the first letter of the command you want. 


3. To return to text, press any key. 


Special Keys on the Rainbow 100 are indicated 
by putting their names in angle brackets. These 
“INSERT HERE>, «REMOVE>, <FIND>, 

<PREV SCREEN>, «NEXT SCREEN>, cHELP>, 


<DD>, ¢RETURN>. 


TIPS: - 


Screen 25b. RED Help Command 


You can request help for any RED command by repeating the previous 
steps. When you have finished reading the information, press any key to 


return to the document. 
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Ending Work with a Document 

The Quit command (Q) ends your work on a document. Type: 

a 

RED displays the options shown in Screen 26 asking whether you want to 


keep, abandon (not keep the version of the document you have just created 
or edited), or return’to the document. 


2QUIT: Keep Abandon <DO> Wf 
Document: B:MEMO. TXT 


Keep ~ this will save any changes made | 
since the last editing session. 


Abandon - this will end editing WITHOUT 
saving the changes made 


«D0» ~ go back to document 


Screen 26. Quil Options 


For this example, keep the text and all changes you have made. Type: 


K 
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RED displays the following message on the screen: 


Keeping 
B:MEMO.TXT 
please stand by... 


The operating system then displays its prompt, A>, indicating it is ready to 
accept another operating system command. 


To confirm that the MEMO.TXT file has been saved, display the directory 
of the diskette, Type: 


ASDIR B: eum 


Screen 27 shows the directory with the MEMO.TXT file included. 


A> 
ADDIR B: 
B: MEMO TXT 
aol 
ey 


Screen 27. Directory of Drive B 
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Storing a New Document on a 
Diskette 


If there is not enough space to store a file on the diskette, after you press 
K, RED displays the following message: 


Sorry can not open document 


This means that the maximum number of files in a directory has been 
reached, Creating or editing the current file exceeds the maximum. 
CP/M- 86/80 allows 128 directory files. 


When you create or edit a file, RED creates a temporary file (with the file 
type .$$0). If the diskette has 127 directory files and you create a file, the 
temporary file becomes file number 128, Therefore, when you finish with 

the file, it cannot be stored on the diskette because the number of files is 

exceeded. RED displays the message and the contents of the current file 

are lost. 


IMPORTANT 

To avoid this message and the loss of your file, 
before using RED, check the directory of the disk- 
ette to make sure that less than 128 directory 
files exist. 


If RED does display the message, before creating another file, you should: 


e Erase any unneeded files on the diskette, or 
* Insert another diskette with free space on it 
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Printing Text 


The Output command (O) sends a marked section of a document to a 
printer. However, before you can print using this command, you must: 


1. Make sure the computer is connected to a printer 


2. Make sure the Set-Up features are compatible with the printer 
characteristics 


(Refer to the Rainbow Owner's Manual for this information.) 
3. Make sure the printer is turned on 


If steps 1 through 3 are not done, you must return to the operating 
system (A>) to do them. 


4, Make sure you are in the editor. If you left the editor, type: 
A>RED BrMEMD. TXT 
RED displays the header lines and the memo. 
Now type: 
o 
The command line changes to: 
>OUTPUT: Top Bottom From 
At this point you can either: 
e Print the whole document by typing 
f 
for top followed by 
6 
for bottom 
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Print a section of the document by setting pointers. (Pointers are 
discussed in Section 2 of this chapter.) 


After you perform one of these steps, the text is printed on the printer. 
The carriage return symbols (<) are not printed. 


NOTE 

You can also print the document, without being in 
the editor, by using PIP. Refer to Chapter 2 for a 
description of the PIP command. 


Section 2 
Advanced Commands 


There are other commands which you can use to perform more advanced 
tasks, such as: 


Combine two or more documents. 

Move sections of text to another location in the same document. 
Copy sections of text within a document. 

Create a new document from a section of an existing document. 
Permanently erase a document. 


Change the column width displayed on the screen. 


To perform these tasks, you must move the cursor. In addition to the keys 
listed in Table 12, there are two other commands and one other key that 
move the cursor: 
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Using the Goto Command 

The Goto command (G) moves the cursor to any of four different locations: 
Top, Bottom, Line, or to any preset pointer. This command is useful for 
moving the cursor quickly. 

Go back to the document by typing: 

A>RED B:MEMO.TXT Caetum) 

Then type: 


6 


In a new command line, RED asks you where you want the cursor to move. 
(See Screen 28a.) 


260 10; Top Bottom Linel 
Document: B:MEMO, TAT 


Denies 
To the staffre 

« 

There will be a staff meetinge 

in the first floor Mayflower Conterencee 
Room at 10:00 A.M. on Tuesday.¢ 

« 


Screen 28a. Using the Goto Command 
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To move the cursor to a specific line, type: 


In a new command line, RED instructs you to type the line number and 
press the Return key, (See Screen 28b.) 


ie 


460 TO: Line: Enter line number; then RET» Ml 
Document: B:MEMO.TAT Char: 1 Line: 1 


To the staf 
« 

There will be a steff meetings 

in the first floor Mayflower Conferencec 
Room at 10:00 A.M. on Tuesday.« 

« 


Screen 28b. Using the Goto Command 


Type: 
4 Return) 


The cursor should now be on the first character (i) in the fourth line. A 4 is 
displayed next to the word “‘Line:” on the Status Line. 
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Using the Locate Command 


The Locate command (L), or the Find key, searches for any character, 
word, or symbol in your document. This command is useful for moving the 
cursot quickly to a specific character in the document. 


A search always moves in the direction indicated by the angle bracket to 
the left of the word “RED:” in the command line. Before using the Locate 
command, you should check the direction of the angle bracket. If it is not 
pointing in the desired direction, change it by typing the left angle bracket 
key (<) or-—, or the right angle bracket (>) or +. To be sure that RED 
finds the first location of the specified text, move the cursor to the top of 
your document and type: 


t 


In a new command line, RED instructs you to enter the text you are 
searching for and press the Return key when finished. 


The number 1 in front of the command indicates that only the first occur- 
rence of the entry is being searched for. If you want to search for any 
other occurrence, type the number followed by L. For example, if you want 
to locate the fifth occurrence of the entry, position the cursor at the top of 
the document and type: 


SL 
NOTE 
It is important to type the text exactly as it was 
typed in your document. This includes using 
uppercase and lowercase characters where appro- 


priate. To locate a word like “the” which may be 
part of ‘“‘other’’, do the following: 


Type a space 
Type the 
Type another space 
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For this example, type: 


10100 (Rem) 


The cursor moves to the 1 in 10:00" and the first command line 
redisplays on the screen. (See Screen 29.) 


DRED: Insert Erase Rointer Goto Locate Replace Display Guit Next 
Document: B:MEMO.TxT Char; 9 Liner 5S 


There will beve staf meetings 
An'the thrat floor Mayfiaver Conferencee 
Room at f]0:00 A.M, on Tuesday.< 

4 


Screen 29. Locating Text 


Note that RED also displays the character number and line number on the 
status line. You can now perform one of several tasks, such as erasing, 
moving, or replacing the text. 
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Viewing Another Document 


The View command (V) allows you to view one document, while editing 
another document. This command is useful if you need to make a reference 
in the current document to something specific in another document. Type: 


Vv 


In a new command line, RED asks you to type the name of the document 
you want to view, then press the Return key. For this example, type: 


A:PRACTICE. TXT CRetwm 


NOTE 
PRACTICE.TXT already exists on the diskette 
containing the CP/M-86/80 operating system. 


RED displays the document PRACTICE.TXT in the lower half of the 
screen, (See Screen 30.) The text is also in a lower intensity than the 
document you are working on. To return to the document you are working 
on, press the Do key. 
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(— wy 
2VIEW: Press any key to continue viewing or <DO> 
Document: B:MEMO.TXT Cher: 4 Liner 4 


There will be @ staff meetings 
in the first floor Mayflower Conferencec 
Room at 10:00 A.M. on Tuesday.¢ 

« 


This is a test: 


Today you will practice 
using all of the RED commands until 
you have them all mastered. 


Lu 


Screen 30. Viewing Another Document 


NOTE 

If the current document is long, RED scrolls a few 
lines out of view until there is enough space on 
the screen for the document you want to look at. 


Listing Document Names 


The Append command lets you either see a directory list of document 
names or add an existing document to the end of another. To see a list of 
document names, type: 


RED displays the two APPEND commands: List and Insert. List is the 
same as the CP/M-86/80 command, DIR. However, using List prevents you 
from having to leave RED, return to the operating system prompt, and type 
the DIR command to list the directory of your files. 
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To list your file names from RED, type: 
L 


RED requests the drive name. At this point, you can do any of the 
following: 


e List all your documents by typing the name of the drive you are 
working on, then: pressing the Return key. Type: 


B: Hew) 


The Append command is displayed again. Below the command line, the 
file names are listed. (See Screen 31a.) 


DAPPEND: List Insert 

Document: B:MEMO.TXT Char: 1 Liner 7 

firankcen aan tsnae atte pen theerembenns Gtbbhas eran ges edshacas~ciacuncbcaceopeltap! R 
B: MEMO 480 B:MEMO TxT 

There is space for 382,000 characters on this disk; {t as 2% full 


Screen 31a. Append Command: List 
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© List a group of documents by using wildcards. Type: 
B:*.7XT Cewm ) 


e List one document by typing the drive name and the name of the 
document. Type: 


B:MEMO. TXT Chew) 
To return to the document, press the Do key. 
If you look at the entire list, you see that, in addition to MEMO.TXT, there 


is a document called MEMO.$$0. This is a temporary document that RED 
creates. 


Appending One Document to 

Another 

The Append Insert command allows you to append an entire document to 
the end of another document. This command is useful, for example, if you 
created a report as one document and a chart as another document. Then 
you wish to combine the chart into the report. 


To add PRACTICE.TXT to the end of MEMO.TXT, move the cursor past 
the last carriage return at the end of the memo. Then type: 


A 
In response to 
>APPEND: List Insert 
type: 


I 
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RED instructs you to enter the file name and then press the Return key. 
Type: 


ArPRACTICE.TAT CRewm 


NOTE 
Be sure to include the drive name (A:). 


RED appends the document PRACTICE.TXT to the end of the document 
MEMO.TXT. 


Screen 31b shows the two documents together. 


DRED: Insert Erase Pointer Goto Locate Replace Display Quit Next 
Document: B:MEMO.TXT Char: 1 Lines = 7 


There will be a staff meetinge 
in the first floor Mayflower Conferences 
Room at 10:00 A.M. on Tuesday,< 

« 

Brie tain testes 

< 

Today you will practices 

using all of the RED commands untile 
you have them all mastered. ¢ 

4 


Screen 31b. Appending Two Documents 
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Using Pointers with Commands 


The Move, Copy, Zap, Output, and Write commands are used in conjunction 
with the Pointer command (P). Pointers act as markers to section off por- 
tions of text for moving or erasing. You can set up to eight pointers and 
can reassign a pointer by reusing the number. 


The general procedure for using these commands is as follows: 


Move the cursor to a location. 
2. Type 


P 


Type a pointer number (1-8). 

Repeat steps 1, 2, or 3 if necessary, using different pointer numbers. 
Type the Move, Copy, Zap, Output, or Write command. 

Type the number of the pointer. 


AU et as 


Repeat step 6 if necessary. 


The following examples show you how to use pointers to move, copy, and 
erase text, 


Moving Sections of Text 


The Move command (M) moves a marked section of text from one part of a 
document to another. This is a useful command if you want to move an 
entire paragraph or section of a document to another location within the 
document. 


In the newly combined documents, moye the cursor to the “T” in “This” in 
the seventh line. Type: 


Pp 


In a new command line, RED instructs you to set a pointer using the 
numbers 1 through 8, 
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Type: 


RED marks the spot with a [1] in a lower intensity than the rest of the 
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screen. (See Screen 32a.) 


DRED: 


« 


< 
« 
Today 


using 


« 


Insert Erase Pointer Goto Locate Replace Display Guit Next 


Document: B:MEMO. TXT Char: 1 Liner 7 


To the staff:<¢ 
There will be @ staff meetinge 
An the first floor Mayflower Conferencec 


Room at 10:00 A.M. on Tuesday.< 


Drthis iso test: 


you will practicec 
all of the RED commands until< 


you have them all mastered.< 


Screen 32a. Setting the First Pointer for Move 
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To set the next pointer, move the cursor to the line after the last line of 
text. The first marker [1] temporary disappears. 


If you move the cursor with the GB (Goto Bottom) command, the top line 
of text scrolls out of view. 


You are now ready to set the second pointer. Type: 

Pp 

RED again instructs you to set a pointer. Type: 

RED sets the second pointer at the end of the text and redisplays the first 


pointer and the command line. The pointers are displayed in a lower inten- 
sity than the rest of the screen. (See Screen 32b.) 


>RED: Insert Erase Pointer Goto Locate Replace Display Guit Next 
Document: B:MEMO.TAT Chars 1 Line: 13 


Lena ne nee nnn nnn nn ne ee ne ene nee nee nee nee en eee ee eee R 
in 1 lay 
Room at 10: on Tuesday.¢ 

« 

(11This ts a testr« 

« 

Today you will practicec 

using all of the RED commands untii¢ 
you have them all mastered.¢ 


tay 


ower Conferencec 


Screen 32b. Setting the Second Pointer for Move 
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Now, move the cursor to the top line of text using the GT (Goto Top) 
command. This indicates where you want the text moved. When you move 
the cursor, all pointer markers disappear from view, 

You are now ready to execute the Move command. Type: 


m 


RED asks you to indicate the beginning of the text you want to move. (See 
Screen 32c.) 


»MOVE: Top Bottom 1 2 Froml 
Document: B:MEMO, TXT Char: 1 Line: ' 


To the staffre 
« 

There will be a staff meetings 

in the first floor Mayflower Conferences 
Room at 10:00 A.M. on Tuesday. < 

« 

This tsa testr« 

« 

Today you will practicee 

using all of the RED commands untile 
you have them all mastered. 

< 


Screen 32c, Moving Text 
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Four choices are shown on the command line: Top, Bottom, (Pointer)1, and 
(Pointer)2. Type: 


RED now asks you to indicate the end of the text you want to move, 
Type: 


2 


RED redisplays the command line and reverses the two documents. (See 
Screen 32d.) The two documents are now reversed. 


RED: Insert Erase Pointer Goto Locate Replace Display Quit Next 
Document: B:MEMO.TXT Char: 1 Line: 1 


L 


Pris ince teatee 


« 


Today you will practices 

using all of the RED commands untile 
you have them all mastered.<¢ 

« 

To the staff:« 

« 

There will be @ staff meetinge 

in the first floor Mayflower Conference< 
Room at 10:00 A.M. on Tuesday.<« 

« 


Screen 32d. Moved Text 
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Copying Sections of Text 

The Copy command (C) copies a marked section of text from one part of a 
document to another. This is useful if you are using the same information 
in more than one place in the document. 


Make sure the cursor is at the top of the document bu using the GT (Goto 
Top) command. 


You are now ready to set pointers. Type: 
Pp 
RED displays the location of the pointers that were set in the Move com- 


mand. Both the pointers on the command line and in the document are 
displayed in a lower intensity than the rest of the text. (See Screen 33a.) 


SET POINTER 12345678 
Document: B:MEMO. TXT Char: 1 Line: 1 


Today you will practicee 
using all of the RED commands until< 
you have them all mastered. ¢ 

« 

To the staffi¢ 


< 
There will be @ staff meetinge 

in the first floor Mayflower Conferencec 
Room at 10:00 A.M. on Tuesday.¢ 

« 

[apical 


Screen 33a. Setting Pointers for COPY 
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You can reset the two pointers using the same numbers. When you do this, 
you delete the previously set pointers. Type: 


) 


RED resets the first pointer. The second pointer currently remains set at 
the end of the text. 


Move the cursor to the carriage return symbol after the last line of text in 
PRACTICE.TXT. Type: 


‘Then type: 
2 


The second pointer is now reset as shown in Screen 33b. 


DRED: Insert Erase Pointer Goto Locate Repla 
Document: B:MEMO, TXT 


Display Quit Next 
1 Lines 6 


1y)This is @ tes 
« 

Today you will practicee 

using all of the RED commands untile 
you have them all mastered.¢ 

fe 

To the staffre 

« 

There will be a staff meetinge 

in the first floor Mayflower Conferencec 
Room at 10:00 A.M. on Tuesday. <¢ 

« 


< 


Screen 33b. Pointers Set for Copy 
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To copy the marked text at the end of the second memo, move the cursor 
to the carriage return symbol on the line following the last line of text. 


Now use the Copy command. Type: 


c 


RED asks you to indicate the beginning of the text you want to copy. Type: 


RED now asks you to indicate the end of the text you want to copy. Type: 


RED copies the marked text and places it after the current cursor position. 


(See Screen 33c.) 


This is @ test: 
« 


Today you will practicec 
using all of the RED commands untile 
you have them all mastered.<« 

Brie asia tearee 

< 

Today you will practicee 

using ell of the RED commands untile 
you have them all mastered.¢ 

« 

To the staffre 

« 

There will be a staff meetings 

in the first floor Mayflower Conferencee 
Room at 10:00 A.M. on Tuesday.< 

« 


DRED: Insert Erase Pointer Goto Locate Replace Display Quit Next 
Document: B:MEMO.TXT Char: 1 Lane: 


6 


Screen 33c. Copied Text 
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Creating a New Document from an 
Existing Document 


The Write command (W) creates a new document containing sections of 
text that you mark in an existing document. It is a useful command for 
creating stock paragraphs for form letters, memos, or contracts. 

Move the cursor to the beginning of line 12: ‘‘To the Staff:"’. Type: 

F 

RED displays the pointers that you set using Copy. 

To reset the first pointer, type: 


1 


Move the cursor to the carriage return character at the end of the 
document. 


To reset the second pointer, type: 
Pp 

and then type: 

2 


RED displays the two new pointers. (See Screen 34a.) 
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RED: Insert Erase Pointer Goto Locate Replace Display Quit Next 
Document: 


Today you will practicec 
using all of the RED commands until< 
you have them all mastered.« 
This is @ testr« 
‘ 
Today you will practicee 
using all of the RED commands untile 
you have them all mastered.< 
« 
(11To the staffr< 
“ 
There will be o staff meetings 
in the first floor Mayflower Conferencec 
ee at 10:00 A.M, on Tuesday.<« 
) 


Screen 34a. Setting Pointers for Write 


You are now ready to use the Write command to create a new document. 
Type: 


W 


RED asks for the beginning and end of the text you want copied to the new 
file. Type: 


Then type: 


179 


Creating and Changing a Document 


RED then requests a document name. (See Screen 34b.) 


2WRITE: Top Bottom 1 2 From 1, te 2 te Document 
Document: B:mEMO. TXT : 


L 
This is a testr« 

« 

Today you will practicee 

using all of the RED commands until 
you have them all mastered.« 

This is @ testre 

« 


Today you will practicec 
using ell of the RED commands untilé 
you have them all mastered.< 

« 

To the staff: 

< 

There will be @ staff meetings 

in the first floor Mayflower Conferencec 
Room at 10:00 A.M. on Tuesday.<¢ 


Screen 34b. Write Command 


Remember that RED accepts only valid CP/M-86/80 file names. Type: 


BeMEETING, TXT Chotwm) 
RED displays the command line, but does not change the text. However, 


the pointers are no longer visible. Now the marked section is in the file 
MEETING.TXT. 
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Looking at the New Directory 


To make sure the new document exists, use the View command, or return 
to the operating system and look at the directory as follows: 


1. Type Q for Quit. 
2. Type K for Keep. 

You are now back to the operating system. 
3. Next to the system prompt, type: 


Aa DIR Bz CRetum 


The CP/M-86/80 operating system displays the file directory as shown in 
Screen 34c. You now have the original document in MEMO.TXT and the 
new document in MEETING.TXT. (Remember that PRACTICE.TXT is on 
the system diskette in drive A.) 


ASDIR Bt 
BiMEETING TXT : MEMO TXT : MEMO BAK 
oll 


Screen 34c. Directory Showing New Document 
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Permanently Erasing Sections of Text 


The Zap command (Z) permanently erases marked sections of a document. 
You should use this command with care. 


Reenter the document, MEMO.TXT, byt typing: 

ASRED B; MEMO. TXT Crem) 

Moye the cursor to the beginning of line 6: “This is a test:’”’. Type: 
P 


RED instructs you to set a pointer. Type: 


Move the cursor to the carriage return symbol at line 11, Type: 
P 


Then type: 


RED resets the second pointer. (See Screen 35a.) 
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ee 


DRED: Insert Erase Pointer Goto Locate Replace Display Quit Next 
Document: B:MEMO. TXT Char: 1 Lines 11 


Today you will practicec 
using all of the RED commands untile 
you have them all mastered.< 
Li}This is a test: 


« 
Today ga0. iti practices 

using all of the RED commands untilé 
you have them all mastered.¢ 

2 

To the staffre 

« 

There will be @ staff meetinge 

in the first floor Mayflower Conference 
Room at 10:00 A.M. on Tuesday.< 

« 


Screen 35a. Setting Pointers for Zap 


You are now ready to erase the marked section of text. Type: 
z 


RED asks you to indicate the beginning and end of the text you want to 
erase. The pointers are no longer visible. Type: 


Then type: 
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RED erases the section you indicated and the original text remains. (See 
Screen 35b.) 


DRED: Insert Erase Pointer Goto Locate Replace Display Quit Next 
Document: B:MEMD, TXT Char: 1 Liner 6 


This is @ testre 


‘ 
Today you will practicec 

using all of the RED commands until¢ 
you have them all mastered.< 

< 

To the staffie 

« 

There will be @ staff meeting 

in the first floor Mayflower Conferencee 
Room at 10:00 A.M. on Tuesday.< 

« 


Screen 35b. Erased Text Using Zap 
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Changing Column Width 


Normally, the width of the text displayed is 80 columns, However, if you 
have a large chart that is wider than 80 columns, you can change the width 
of the display on the screen as well as the width of the printed copy. To 
change the width from 80 columns to 132 columns, first leave the editor. 
Then, next to the system prompt, type: 


A>RED B:MEMD.TXT/W (fewm) 


Screen 36 shows the text in small column width. When you return to the 
operating system, the original width of 80 columns automatically returns, 


Today you «i1) practices 
sing mil ef the REO vommanae untite 
you have them ail wastered.¢ 


Screen 36. 132 Column Width 
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Creating a . 
System/Application Diskette 


This chapter describes the procedure to create a diskette that includes the 
program you need to start the operating system as well as an application 
program. This will become the system/application diskette. 


Application programs solve specific problems or do specific jobs, such as 
word processing (SELECT-86), or financial planning (Multiplan-86). 


Why Create a 
System/Application Diskette? 


If you are using an application program routinely, you should copy the 
operating system programs and the application program to a single diskette. 
By doing this, you can use the same diskette to start the operating system 
and also to run the application program. Because you use one drive for this 
diskette, you have a free drive for a data diskette: a diskette that you use 
with the application program to store information, such as the text of a 
memo, 
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Application programs you can copy include; 


Programs created for the Rainbow computer. 


Programs configured for DIGITAL’s VT180 personal computer (refer 
to the application program’s documentation to determine if the pro- 
gram can be configured for the VT180 personal computer) 


Programs stored on an 8-sector, single-sided IBM diskette. 


How to Create a 
System/Application Diskette 


Follow the steps in the next two sections of this chapter to make a sys- 
tem/application diskette. 


i 


In the section titled: “‘Copying the Operating System Files,"’ you copy 
the operating system onto a blank diskette. 


In the section titled: “Copying the Application Program’’, you copy 
the application program from a Rainbow compatible diskette, an IBM 
compatible diskette, or a VT180 compatible diskette onto the diskette 
to which you just copied the operating system. 


Copying the Operating System 
Files 


HK 


188 


Display the Rainbow Main System Menu according to either of the 
following procedures: 


© Turning on the Rainbow computer if it is turned off, 
e Resetting the Rainbow computer if it is turned on. 


Remove the CP/M-86/80 working diskette (the diskette you copied in 
the Rainbow CP/M-86/80 Getting Started manual) from its protective 
envelope. 

Open the drive A door and insert the CP/M-86/80 working diskette. 
Close the drive A door. This diskette cannot have a write-protect 
tab on its write-protect notch. 
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4. Start the CP/M-86/80 operating system by pressing the A key in 
response to the Main System Menu. A> should be the last characters 
displayed on the screen. 

5, Remove a blank diskette from the diskette box in the CP/M-86/80 
Operating System Kit, This will become the system/application disk- 
ette containing: 


© The essential operating system files needed to start the operating 
system, 


e The system programs: MAINT, PIP, DISKCOPY, COPY, STAT and 
SUBMIT, 


¢ The application program. 


6, Open the drive B door and insert the blank diskette. Close the drive B 
door, 


NOTE 

If you did not turn on or reset the computer 
before inserting the diskettes, by pressing the 
Set-Up key followed by holding the Ctrl key and 
pressing the Set-Up key at the same time, type 
Ctrl/C after the prompt to tell the operating sys- 
tem that you have inserted new diskettes into the 
drives, 


NOTE 
If any messages are displayed at any time during 
the following procedure, refer to Appendix B of 
this guide, For example: 

DRIVE NOT READY -- OPEN DOOR OR NO DISKETTE 


indicates that there is no diskette in drive B. 
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7. After the A>, type: 
A> SUBMIT SYSCOPY A B Cfeum) 


This instructs the operating system to run a program called SYSCOPY 
to copy the necessary files and programs from the 

CP/M-86/80 working diskette in drive A to the blank diskette in drive 
B. After you type this command, the operating system displays other 
instructions as shown in Screen 37. (The entire procedure should 
complete in about two minutes.) 


A>SUBMIT SYSCOPY A B 
A>LDCOPY A: Br 
LDCOPY VERS 1.6 


A>PIP Br = A:*.SYSCROVI 


COPYING - 
cPM.SYS 
ZS0CHF.SYS 


A>PIP Br *A:MAINT. CMDLROVI 
A»PIP B:*A:PIP.CMDIROV) 
A>PIP B:+A:DISKCOPY.COMCROVI 


ADPIP B 


:COPY.COMEROV] 


ADPIP B. 


UBMIT. CMDEROVI 
A>PIP B:#A:STAT.CMDIROV) 
A>PIP B:*A:HELP.*(ROV) 


COPYING - 
HELP .CMD 
HELP .HLP 


Screen 37. SYSCOPY Dialog 
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8. Check that all the files with the Directory attribute were copied. After 
the operating system prompt, type: 


A>DIR B: (hewn ) 


The file names and prompt should be displayed on the screen as 
shown in Screen 38. 


A2DIR B: 
B: MAINT cmp : PIP CMD : DISKCOPY COM + SUBMIT CMD 
B: STAT CMD : HELP) CMD 


SYSTEM FILECS) EXIST 


oll 


Screen 38. Directory File Names on the Diskette in Drive B 
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9. Check that all system files were copied. After the system prompt, 
type: 


A>DIRS B: (Rewm ) 


The file names and prompt should be displayed on the screen as 
shown in Screen 39. 


ADDIRS Br 
B: CPM SYS : Z2B0CKF SYS : COPY COM : HELP HLP 


NON-SYSTEM FILE(S) EXIST 
Am 


Screen 39. System File Names on the Diskette in Drive B 


You have now successfully copied the operating system files to the diskette 
in drive B. Go to the next section to copy the application program onto this 
diskette. 
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Copying the Application Program 


1 


Remove the CP/M-86/80 working diskette from drive A. Return it to 
its protective envelope and store it in a safe place. 


Remove the other diskette from drive B. This was the blank diskette 
to which you have just copied the operating system files. 


3. Insert this diskette into drive A and close the door, 


4. Insert the application program working diskette into drive B. (This is 


the diskette that the application package, such as SELECT-86 or 
Mulitplan-86 is stored on.) Close the drive B door. 


To tell the operating system that you have changed diskettes, type: 
A> Come) 


Copy the application program (in drive B) onto the diskette already 
containing the operating system (in drive A). To do this, use PIP, the 
command that copies files from one diskette to another diskette, The 
number of files that make up an application program working diskette 
varies, Hence, the time it takes to copy these files will vary. 


NOTE 
If any messages are displayed at any time during 
the following procedure, refer to Appendix B in 
this guide. 

Type: 


ASPIP Ar=B:*, *(ROV) Chew 


where: 
A: is the location you are copying to (the destination drive). 
B: is the location you are copying from (the source drive). 


** — is a symbol indicating all files. 
[ROV] are added instructions for PIP. 
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As the application program files are being copied, PIP displays: 
COPYING -- 


followed by a list of all the file names as they are copied. The file 
names are the same names as those on the source diskette in drive B, 
When all the files are copied, the operating system displays: 


A> 


7. Remove the application program diskette from drive B. Return it to its 
protective envelope and store it in a safe place. The diskette in drive 
A is now the system/application diskette, 


8. If desired, you can now insert a data diskette into drive B to use with 
the application program. If you insert another diskette into the drive, 


type: 
A> Gane) 
to let the operating system know you have changed diskettes. 


With this one diskette, you can now start the operating system and use 
your application program. Use this procedure to make system/application 
diskettes for as many application programs as you have, Be sure to write 
the following information, with a felt tipped pen, on the system/application 
diskette’s label: 


¢ The name of the operating system that is stored on the diskette: the 
CP/M-86/80 operating system. 


e The name of the application program that is stored on the diskette. 
Described above is the preferred method of creating a system/application 


diskette. Refer to the discussion of the SUBMIT program in Chapter 2 of 
this guide if you want to customize this procedure to copy other files. 
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Starting Application Programs 


To start the application program, refer to your application program’s docu- 
mentation. In most cases, you type the name of the program followed by 
pressing the Return key. 


IMPORTANT 

If your application program requires you to change 
diskettes, you may need to type Ctrl/C before 
starting the program. This prevents the program 
from stopping. 


Typing Ctrl/C directly after the prompt, tells the 
operating system that you have inserted a differ- 
ent diskette into the drive. Typing Ctrl/C after the 
application program has started can cause the pro- 
gram to stop. Refer to the application program’s 
documentation for specific instructions. 


If you are using an application program for the first time, you should type 


some test information on the diskette to ensure that the program is work- 
ing correctly. 
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Cursor Movement in VT180 Programs 


While running certain application programs configured for digitals VT180 
personal computer, the directional arrow keys: the up, down, left and right 
arrow keys, may not move the cursor properly. In this case, use the corre- 
sponding control characters listed in Table 13 instead of the arrow keys: 


Table 13. Control Characters 


Directional 
Arrow Keys Control Character Keys 


Up Arrow (@) 
Down Arrow (#) 


Right Arrow (#) 


ABER 


Left Arrow 
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Copying Data or Programs from 
VT180 or IBM Diskettes 


If you want to copy the data files or programs you have stored on VT180 
diskettes to a Rainbow diskette, follow the steps below. 


I. 


7. 


Display the Rainbow Main System Menu according to one of the fol- 
lowing procedures: 


e Turn on the Rainbow computer if it is turned off. 
© Reset the Rainbow computer if it is turned on. 


Remove the CP/M-86/80 working diskette from its protective 
envelope. 


Open the drive A door and insert the CP/M-86/80 working diskette. 
Start the CP/M-86/80 operating system by pressing the A key in 
response to the Main System Menu. A> should be the last characters 
displayed on the screen. 

Remove the VT180 or IBM diskette from its protective envelope. 
Open the drive B door and insert the VT180 or IBM diskette. 


NOTE 

If you did not turn on or reset the computer just 
before inserting the diskettes, type Ctrl/C to tell 
the operating system that you nave inserted new 
diskettes into the drives. 


Use PIP to copy all or some of the data files or programs from the 
VT180 or IBM diskette to the CP/M-86/80 working diskette. 


NOTE 

If any messages are displayed at any time during 
the following procedure, refer to Appendix B of 
this guide. 
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Type: 


A>PIP Az=B:*.*CROV] Geum) 


or 


A>PIP Ar=B:filename,typ (V1 Gaaum) 


IMPORTANT 

If there is not enough space to copy all your 
VT180 data files onto the CP/M-86/80 working 
diskette, PIP displays the following error message: 


ERROR: diskette WRITE - [drv:filename. typ] 


If you see this error message, create a system 
diskette with a limited number of files. To do this, 
follow the instructions in the section titled 
“Copying the Operating System Files” at the 
beginning of this chapter. By using the SUBMIT 
program described in that section, you copy only 
the necessary operating system files and five 
operating system programs onto the diskette. 
Then insert this diskette into drive A instead of 
the CP/M-86/80 working diskette as instructed in 
step 3. With fewer operating system files on this 
diskette, you can copy all your VT180 or IBM 
files. You can then copy these files to a separate 
“data” disk, if desired, by using PIP. 
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How To Backup and Restore 
Hard Disk Files 


What is in this Chapter 


This chapter describes how to use the BACKUP program to copy a group 
of files to and from the hard disk. 


Purpose 


BACKUP is a program that allows you to copy files from the hard disk to 
diskettes (backup) and copy them back onto the hard disk (restore). 


Restore is generally done to recover files that were accidentally erased 
from the hard disk. 


Form 


A>BACKUP 


How to Backup and Restore Hard Disk Files 


Instructions 


Backing up files. To backup your files from hard disk to diskettes, follow 
the instructions below: 


1. Set the date and time by typing: 


A DATE dd-man-yy hhimmsss 
Where: 

dd 

Is the day 

mon 

Are the first three letters of the month 
yy 

Are the last two digits of the year 

hh: 

Is the hour 

mm: 


Are the minutes 

Ss 

Are the seconds (optional) 
2. Type: 


A> BACKUP ( 


You see a screen called Main Screen, 


4, According to the instructions at the bottom of the displayed screen, 
select Option 1 by pressing: 


or typing the number ! 
5. Press the Do key. 
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6. From the second displayed screen: Standard Backup Options, press: 
s 
to move the arrow to the first line. Then press: 
= 
to select the source drive (the drive from which the files will be 
copied), 


NOTE 
If you are not sure what an option means, select 
the option by moving the arrow to the option you 
need help on, and press the Help key. 
7, Press: 

s 

again to move the arrow to the second line, Then press: 

» 


to select the destination drive (the diskette drive on which you want 
the files copied.) 


8. Choose to copy: 
¢ All files by not making any more selections and pressing the Do 


key 


© Only files that have changed since the last time the backup 
program was run. To do this, press: 


s 
to move the arrow to the third line. Then press: 
> 


to select the CHANGED option. Press the Do key, 


After the BACKUP program starts, you are prompted to insert a diskette. 
When that diskette is full, you are prompted to insert another diskette. 
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As BACKUP copies the files, each file name is displayed on the screen. 
When the program is done you see a brief message indicating that the 
back-up procedure has completed, and the Main Screen is displayed again. 


Each backup option is described in Chapter 6. 


Restoring Files. To restore files from diskettes back to the hard disk, 
follow the instructions below: 


1, Type: 
A> BACKUP Caeum > 


2, From the main Screen, press: 
’ 
or type the number 2 to move the arrow to the second line. 
3. Press the Do key, 
From the second displayed screen: Standard Restore Options, press: 
s 
to move the arrow to the first line. Then press: 
2 


to select the source drive (the drive from which the files will be 
restored.) 


5. press: 
o 
again to move the arrow to the second line. Then press: 
» 


to select the destination drive (the diskette drive onto which you want 
the files restored.) 
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6. Choose to restore: 


e All files by not making any more selections and pressing the Do 
key 

* Certain files that you specify. To do this, press: 
’ 
to move the arrow to the third line. Then type the names of the 
files you want restored, Then press the Do key. 


NOTE 

If you are not sure of how to specify a group of 
files, refer to the section called “Restore File 
Specifier” in Chapter 6 of this guide, 


After the program starts, you are prompted to insert a diskette. When all 
the files have been restored from that diskette, you are prompted to insert 
another diskette, 


As BACKUP restores the files, each file name is displayed on the screen. 
When the program is done you see a brief message indicating that the 
procedure has completed, and the main Screen is displayed again. 


Each restore option is described in Chapter 6. 


What To Do Next 


Proceed to Chapter 6 for more information about the hard disk. Chapter 6 
includes: 

© Starting the operating system from the hard disk. 

® Changing the default partitions. 

¢ Detailed features of the backup and restore program. 

® Recovering from hard disk problems. 
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Advanced Hard Disk 
Procedures 


What is in this Chapter 


In Chapter 5, you learned the basic procedure for backing up and restoring 
files, 


This chapter describes how to use the hard disk for more detailed opera- 
tions. The chapter is divided into a description of the hard disk followed by 
four sections that show you how to: 


1. Start the operating system from the hard disk 

2. Change the default partitions 

3. Backup and restore operations (advanced features) 
4. Recover from hard disk problems 
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What is a Hard Disk? 


The hard disk (called a Winchester disk) can be added onto the Rainbow 
computer. This disk provides greater storage for large files or many small 
files, and greater speed in using files. 


In terms of type-written pages, a diskette stores about 150 pages of text; 
the hard disk stores about 3750 pages, 


NOTE 

If you have a disk with a storage capacity of five 
megabytes instead of ten, the number of pages is 
half this amount. 


The hard disk provides you with additional space that is defined in 
megabytes, A byte is equal to one character, and a megabyte is equal to a 
million characters. The hard disk provides you with ten megabytes of addi- 
tional storage space, which is equivalent to 25 times the storage capacity of 
a single diskette. 


The disk can simulate up to four diskette drives, each with a much larger 
capacity than a single diskette. 


Because of its speed and large working capacity, you may want to use the 
hard disk to store the programs and files you use daily, and use diskettes 
for storing less-used files. 


NOTE 

If you are using an application program, it is rec- 
ommended that you store it on the hard disk and 
store data files on diskettes. 


Figure 11 shows where the hard disk fits into the Rainbow computer. 
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MONITOR 
SYsTEM \ | 
UNIT 


eee 


Figure 11. The Hard Disk in the Rainbow Computer 


For a description of installation procedures, refer to the Rainbow 
Winchester Disk Option Installation Guide. 
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Section 1 
Starting the Operating System 
from the Hard Disk 


Make sure the hard disk is installed according to the procedures in the 
Rainbow Winchester Disk Option Installation Guide, and you have run the 
install program described in the same guide. 


To be able to automatically start the CP/M-86/80 operating system from 
the hard disk, follow the instructions below: 


1. 
2. 
3. 
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Turn on the computer. 
Insert the operating diskette into drive A. 
From the Main System Menu, type: 


NOTE 

If the W option is not displayed on the Main Sys- 
tem Menu, you cannot start the operating system 
from the hard disk. You can, however, use the 
hard disk to store and work with files. 


You must then copy the operating system onto the hard disk. To do 
this, in response to the system prompt, A>, type: 


A>SUBMIT SYSCOPY Al devi 


Where dry: is the hard disk drive from which you want to start the 
operating system. 

This instructs the operating system to run the program called 
SYSCOPY to copy the necessary operating system files and programs 
from the diskette in drive A to the hard disk drive E. After you type 
this command, the operating system displays other instructions to 
complete the procedure. 


Advanced Hard Disk Procedures 


NOTE 
Proceed to Step 5 only if you see the message 


Cannot find file: HBOOT.LDX on source diskette 
Try LDCOPY drv:HBOOT.LDX if you want to copy a loader 
to the hard disk 


Otherwise, the system responds with the A> prompt, and you 
can proceed to step 6. 


Run the CP/M-86/80 program called LDCOPY by typing: 

A>LDCOFY A:HBOOT.LDX (Reum) 

You are then asked to supply the destination drive name. Type: 

drvi CReum ) 

In this example, 

A: Is the source drive from which you are copying the 


program called HBOOT.LDX. 


HBOOT.LDX Is the name of the program that you are copying 
from drive A. The LDCOPY program copies 
HBOOT,LDX onto the specified destination drive 
(drv:) to designate that hard disk drive as the one 
from which the operating system will run. 

drv: Is the hard disk drive from which you want to start 
the operating system. 


When LDCOPY has finished, it displays the message: 


Function complete 


. Locate the Rainbow hard disk utility program diskette that came in 


the same box with the Rainbow Winchester Disk Option Installation 
Guide. Insert this diskette into drive A. 


. Type: 
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8. From the Main System Menu, type A. The Main Screen is displayed 
as shown in Screen 40. 


RAINBOW Hard Disk Utility Program (Version 0.16) 


Main Screen 
“> 
1. Test and initialize the hard disk 


2. Re-partition the hard disk 
3. Show hard disk status 
4. Run the hard disk diagnostic 
S. Re-initialize the hard disk 
6. Select auto-boot partition 

To point to # selection, press the up arrow tey, down arrow key 
or a number key, 

On 6 line, press Help» for more information 

To begin the selected action, press <Do> 


When finished with this program, insert system diskette into Drive A 
and press ¢Set-Up> followed by <CTRL/Set-Up>. 


Screen 40. Main Screen 


9, From the Main Screen, press the down arrow key or type the number 
6to select Option 6: Select auto-boot partition. Then press the Do 
key. 
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Assuming you haye not changed the default partitions, the following 
screen is displayed: 


f RAINBOW Hard Disk Utility Program (Version 0.16) 
Auto-Boot Partition Menu 


Please select the partition from which you want auto-booting to occur: 
( * + current auto-boot setting? 


Partition Operating 
Nome Drive System 
> 
1. OPM-4 E cP/M-86/80 
2, OPM-2 F cP /M-86/80 
3, * None 


For more information, press ¢Help>. 

To change the auto-boot setting, press the up errow key, down arrow key, 
or 8 number key to point to a selection, then press <Do>. 

When the auto-boot setting Is correct, press «Main Screen (F9)> to 
return to the Mein Screen. 


Screen 41, Auto-Boot Partition Menu 


10. You must then select the drive from which you want the operating 
system to start the next time you turn on the computer. The choices 
depend on the partition arrangement you have selected. In this case, 
the drives are E, F, or none. The selection must match the drive you 
specified with the SUBMIT command. Make the selection by pointing 
to it with the arrow, then pressing the Do key. 


11. After you make a selection, the asterisk (*) moves to that selection. 


12. Follow the instructions at the bottom of the auto-boot partition menu 
to return to the Main Screen. 


13. From the Main Screen, follow the instructions to insert a system 
diskette into drive A and press the Set-Up key followed by Ctr!/Set- 
Up. This action causes the Main System Menu to be displayed. 
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14. From the Main System Menu, press the Set-Up key. 
15, Press the Next Screen key until you see: 


SET-UP 


TO EXIT PRESS “SET-UP™ 


E_<CTRL/SET-UP> 


AuTO-BOOT 


Beprive 


Then press the up arrow key until the ? changes to W (for Winchester 
hard disk). Then press the Shift and S keys simultaneously to save the 
change you have made to the Set-Up parameter. Press the Set-Up key 
again to leave Set-Up, (Refer to the Rainbow Owner's Manual for 
more information about Set-Up.) 

16. The next time you turn on the computer, the operating system 
automatically starts from the specified drive on the hard disk. 


NOTE 

You can also start the operating system from the 
hard disk by selecting W from the Main System 
Menu. To do this: 


1. Follow steps 1 through 4. 
2, The next time you reset or turn on the computer, select W from the 
Main System Menu. 


3. After you select W, a screen is displayed with choices of hard disk 
drives. Select the drive that corresponds to the one you specified in 
the SUBMIT command. This is the drive from which the operating 
system will start. 


212 


Advanced Hard Disk Procedures 


Section 2 
Changing the Default Partitions 


Make sure the hard disk is installed according to the procedures in the 
Rainbow Winchester Disk Option Installation Guide, and you have run the 
install program described in the same guide. 


After the disk has been successfully installed, it is automatically divided into 
two CP/M-86/80 partitions of equal size. A partition is a permanent storage 
area. It is similar to a diskette, but stores much more information; it can be 
changed, but not physically removed. 


If you are not sure how the partitions are currently divided, 


1. Turn on the computer. 


2. Insert the Rainbow hard disk utility program diskette into drive A. 
This diskette is found in the box with the Rainbow Winchester Disk 
Option Installation Guide. 


NOTE 


From this point on, this diskette is referred to as 
the utility diskette. 
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3. Type: 


4, Select Option 3: Show hard disk status, from the Utility Program 
Main Screen shown in Screen 42. 


RAINBOW Hard Disk Utility Program (Version 0.16) 


Main Screen 
--> 
1, Test and initialize the hard disk 


2. Re-partition the hard disk 
3. Show hard disk status 
4. Run the hard disk diagnostic 
5. Re-initialize the hard disk 
6. Select auto-boot partition 

To point to @ selection, press the up arrow key, down arrow key 
or a number key. 

On @ line, press cHelp> for more information 

To begin the selected action, press ¢Do> 


When finished with this program, insert @ system diskette into Drive A 
and press «Set-Up» followed by <¢CTRL/Set-Up>. 


Screen 42. Main Screen 


To select an option, press the up or down arrow keys, or type a number 
(1-6). For example, if you type the number 3, the arrow to the left at the 
top of the screen moves to the third option. Then press the Do key to start 
the program. 
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If you have not changed the default partitions, and you select Option 3 from 
the Main Screen, the following is displayed: 


RAINBOW Hard Disk Utility Program (Version 0.16) 


Hard Disk Status 


The hard disk is initialized with the following partitions: 


Partition Operating 
Name Drive System Size 
crM-1 E CP/m-66/80 © 4. 698MB 


cpm-2 F CP/M-96/80 4. 898MB. 


To return to the Main Screen, press «Main Screen (F9)>. 


Screen 43. Default Partitions 


NOTE 

If you have a disk with a storage capacity of five 
megabytes instead of ten, the partition sizes are 
different. 
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Why Change Partitions 


Partitioning is a method of dividing the hard disk into one to four internal 
storage areas. The purpose of partitioning is to allow you to use the stor- 
age space in a way that best fits your needs. For example, if you are using 
more than one operating system, you may need to have one five-megabyte 
partition for one operating system, and two 2.5 megabyte partitions for the ~ 
other. 


NOTE 

If you have a disk with a storage capacity of five 
megabytes instead of ten, the partition sizes are 
different. 


The choices are: 


1. One to four partitions of the CP/M-86/80 operating system only 
One to four partitions of the MS-DOS operating system only 


3. One or two partitions for the CP/M-86/80 operating system plus one 
or two partitions for the MS-DOS operating system 


Changing Partitions 


If you do not want the default partition arrangement of two equal-sized 
CP/M-86/80 partitions of five megabytes each, which was automatically 
selected for you during the installation procedure; 


1. Turn on the Rainbow computer 


2. Locate the utility diskette in the box with the Rainbow Winchester 
Disk Option Installation Guide. Insert the diskette into drive A. 
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3. In response to the Main System Menu, type: 
A 


4, The Main Screen is then displayed as shown in Screen 44. 


RAINBOM Hard Disk Utility Program (Version 0.16) 


Main Screen 
--> 
1. Test and initialize the hard disk 


2. Re-partition the herd disk 
3. Show hard disk status 
4. Run the hard disk diagnostic 
S. Re-initialize the herd disk 
6. Select auto-boot partition 

To point to @ selection, press the up arrow bey, down arrow key 
or @ number key. 

On @ line, press <Help> for more information 

To begin the selected action, press <Do> 


When finished with this program. insert @ system diskette into Drive A 
and press <Set-Up> followed by <CTRL/Set-Up>. 


Screen 44. Main Screen 


5. Select Option 2: Re-partition the hard disk, by pressing the up or 
down arrow keys, or by typing the number 2. 


6. Press the Do key. 


NOTE 

Changing the arrangement destroys any existing 
data. Therefore, if files were previously stored on 
the disk, be sure to back up all files you want to 
save before making a change. 
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When you choose this option, you are given a choice of which operating 
system(s) you want to use: 


RAINBOM Hard Disk Utility Program (Version 0.16) 


Operating System Menu 


Please select the operating systems to be used with the hard disk: 


1. CP/M-86/80 only 
2. MS-DOS only 


3. Both CP/M-86/80 and MS-DOS 


For more information, press cHelp>. 
To point to @ selection, press the up arrow key, down arrow key 
or a number key. 
After pointing to @ selection, press ¢Do> to advance to the next menu. 
To quit and return to the Main Screen, press <Main Screen (FS), 


Screen 45. The Operating System Menu 
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The example in Screens 46a through 47 displays the sequence based on the 
selection of the third option: Both CP/M-86/80 and MS-DOS. If you select 
the third option, there are two screens asking you to select the partition 
combination you want: 


RAINBOW Hard Disk Utility Program (Version 0.16) 


CP/M-86/80 & MS-DOS Partition Menu (Part 1) 


Please select one of the following partition plans for the 
CP/M-86/80 half of the hard disk: 


4. One partition: S MBytes, 


2. Two partitions: 2.5 MBytes each 


For more information, press «Help». 

To point too se. 
or a number key. 

After pointing to @ selection, press <Do> to advance to the next menu. 

To quit and return to the previous menu, press (Prev Screend. 

To quit and return to the Main Screen, press «Main Screen (F9)>. 


tion, press the up arrow key, down arrow key 


Screen 46a. CP/M-86/80 Partition Menu 


NOTE 

If you have a disk with five megabytes instead of 
ten, the partition sizes shown on the screen are 
different. 
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To select an option, press the up or down arrow key, or type a number 
(1-2). Then press the Do key. The second screen is then displayed. 


RAINBOW Hard Disk Utility Program (Version 0.16) 


CP/M-86/80 & MS-DOS Partition Menu (Part 2) 


Please select one of the following partition plans for the 
MS-DOS half of the hard disk: 


=> 
1, One partition: S MBytes, 


2. Two partitions: 2.5 MBytes each 


For more information, press «Help». 

To point to @ selection, press the up arrow key, down arrow key 
or a number key. 

After pointing to a selection, press <Do> to begin repartitioning. 

To quit and return to the previous menu, press (Prev Screen>. 

To quit and return to the Main Screen, press «Main Screen (F9)>. 


Screen 46b. MS-DOS Partition Menu 


To select an option, press the up or down arrow key, or type a number 
(1-2), Then press the Do key. 


The available space is divided equally between the two operating systems. 


From the menus, you can select the new partition arrangement. Then press 
the Do key to begin the repartitioning process. 


When you press the Do key, you are given two warnings that: 


ALL DATA ON THE HARD DISK WILL BE DESTROYED 
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Then the program assures you that: 
Re-partitioning 1s in progress 


followed by the new partition status. Screen 47 is a report of the status if 
you choose to have one partition for the CP/M-86/80 operating system, and 
two MS-DOS partitions, 


~ 
RAINBOW Hard Disk Utility Program (Version 0.16) 

Re-partitioning 18 now completed. 

The hard disk now has the following partitions: 

Partition Operating 

Name Drive System Size 

cpm-1 € CP/N-86/80 4, 898MB 

mspos-1 E ms-pos 2,449"B 

mspos -2 F MS-DOS 2.449"B 

To perform additional actions, press «Main Screen (F392 to 
return to the Main Screen. 

If finished with this program, insert 9 system diskette into Drive A 
and press <Set-Up> followed by <Ctri/Set-Up». 


Screen 47. The Re-partitioned Disk Status 


NOTE 

If you have a disk with five megabytes instead of 
ten, the partition sizes shown on the screen are 
different. 
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Section 3 
Copying Files to and from the Hard Disk 


This section describes how to copy files to and from the hard disk onto a 
diskette. In this section, copying files from the hard disk is referred to as 
“backing up”; copying files back to the hard disk is referred to as 
“restoring”. 


On the CP/M-86/80 system diskette, there is a program called BACKUP, 
which you use to back up and restore files. 


Why Save Files? 


It is important to save or backup all files at regular intervals because a disk 
can become too full, damaged, or accidentally erased. By making back-up 
copies of the files, you can delete them from the daily working space on the 
disk, and restore them to the disk at a later time. The instructions below 
assume that you are starting the operating system from a diskette in 

drive A. 


Using the BACKUP Program 

To run the BACKUP program to either back up or restore files, you must 
have the CP/M-86/80 system diskette in drive A. In response to the 
prompt, A>, type: 


A>HACKUM Charm) 


The menu on the following page is displayed. 
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RAINBOW Backup and Restore Utility (Version 1.0) 


Main Screen 


1. Backup: Copy hard disk files onto backup diskettes 
2. Restore: Recopy files from backup diskettes onto hard disk 
3. Verify: Compare hard disk files to backup diskette files 
4. Directory: List the names of files on backup diskettes 
S. Set the date and time 
6. Exit from this program 

To point to @ selection, press the up arrow tey, down arrow key or 
2 number key. 


On any line, press <Help> for information and instructions. 
Press <Do> to begin the selected action. 


Screen 48. The Backup/Restore Main Screen 


In general, to select an option, press the up or down arrow keys, or type a 
number (1-6). For example, if you type the number 4, the arrow to the left 
at the top of the screen moves to the fourth option. Then press the Do key 
to start the option. 


NOTE 

If you are not sure what an option means, select 
the option and press the Help key. After you have 
received the information you need, press the Prev 
Screen key to return to the Main Screen. 


After you press the Do key and the BACKUP program begins, you are 


prompted to insert a diskette. When that diskette is full, you are prompted 
to insert another diskette until all specified files have been copied. 
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Copying Files From the Hard Disk to 
Diskettes 


Option 1 of the BACKUP program allows you to copy selected files from 
the hard disk to a set of diskettes, which are called the backup diskettes. 
Some or all of these files may be copied back to the hard disk at any time 
with the restore option of the BACKUP program. 


When you select Option 1, you are requested to identify the source and 
destination drives, and the type of files you want to save. (See Screen 49.) 


RAINBOW Ba: 


up and Restore Utility (Version 1.02 


Standard Backup Options 


Source hard disk drive........s0- (novel E F GH T J K 
Destination diskette drive....... (none) A BOC OD 
Type of files to save,..seeeseees fall) Changed 


Brackets surround selected options. 

To point toa line, press the up arrow key or down arrow bey. 

On any line, press cHelp> for information and instructions. 

When all options are set a3 desired, press ¢Do> to begin the backup. 
To see Advanced User Backup Options, press «Next Screens. 

To quit and return to Main Screen, press «Main Screen (F9)>. 


Screen 49. Standard Backup Options 
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To specify the required information: 


1. Press the up or down arrow key to select a line 


2. Press the right arrow key to select an option within a line. As noted at 
the bottom of Screen 49, square brackets surround each selected 
option. Each time you press the right arrow key, the brackets move 
one option to the right 


3. When all selections have been made, press the Do key 


As BACKUP is copying the files, each file name is displayed on the screen. 
When the program is done, it displays a brief message indicating that the 
back-up procedure has completed, and the program returns to the BACKUP 
Main Screen. 


NOTE 

After files have been copied on diskettes, you can- 
not use the files for any operation other than 
restore. 


If the date and time have not previously been set on the computer, you are 
requested to do that at this time, as described in the next section. If the 
date and time have been set, proceed to the section called “ADVANCED 
BACKUP PROCEDURES”. 
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Setting the Date and Time on Backup Diskettes. Before a backup 
operation can be done, the date and time must be set on the computer. If it 
has not been set using the DATE command (at the operating system level), 
when you use BACKUP, the following screen is displayed: 


RAINBOW Backup and Restore Utility (Version 1.0) 


Date and Time 
Please enter the current date and time, 


Date format: dd-mon-yy 
Examples: 23-Jan-85, 8-May-84 


Time format: hhrmm:ss 
Exemples: 16:34:56, 1:45:33 
Pars’ 


Today's date...,,+++---------- 
Current times see ee, e----—-—— 

To point to @ line, press the up arrow key or down arrow hey. 

On any line, press cHelp> for information and instructions. 


When all options are set as desired, press «Do» to set the clock 
To quit end return to Main Screen; press <Main Screen (F9)>. 


Screen 50. Date and Time 


Enter the current date and time on the drawn lines in the following format 
as shown in Screen 50: 


1. The name of the month can be entered in uppercase or lowercase 
characters 
The day and year can be from one to four digits 


3. The hours, minutes, and seconds can each be entered as one to four 
digits. Specifying the seconds is optional. The default value is zero. 
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Press the Do key to set the clock. 


If values already exist for the date and time, you can remove them by 
pressing the delete character key. Then enter the current date and time as 
described. 


If you wish to change the date and time that has already been set, choose 
Option 5: Set the date and time from the Main Screen. 


Advanced Backup Procedures. The directions at the bottom of the 
Standard Backup Options screen include pressing the Next Screen key. If 
you do this, you are given more options for the back-up operation, as shown 
in Screen 51. 


RAINBOW Backup and Restore Utility (Version 1.0) 


Advanced User Backup Options 


> 
Source hard disk drive.... 
Destination diskette drive 
Type of files to save 


+ tnonel EF OHI K 
[none] ABCD 
+ TALL1 Changed 


Backup file specifier 
Backup exclusion file apecifier.......--., ----------- 
Name for backup diskettes..... BACKUP 


Exclude system files from backup [Nol Yes 
Exclude Read-Only files from backup. {Nol Yes 
Delete files after backup. [Nol Yes 
Verify files after backup. {Nol Yes 
Get confirmation before deletes. No Yes! 


To point to @ line, press the up arrow key or down arrow bey. 
On any line, press ¢Help> for information and instructions. 
When all options are set as desired, press <Do> to begin the backup. 
To quit and return to Standard Backup Options, press <Prev Screen. 
To quit and return to Main Screen, press «Main Screen (F9)>. 


Screen 51. Advanced User Backup Options 
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To specify the required information: 


Press the up or down arrow key to select a line 


2. Press the right arrow key to select an option within a line, or type a 
value on the drawn line 


3. When all information has been specified, press the Do key 


As BACKUP is copying the files, each file name is displayed on the screen. 
When the program is done, it displays a brief message indicating that the 
back-up procedure has completed, and the program returns to the BACKUP. 
Main Screen, 


NOTE 

After files have been copied on diskettes, you can- 
not use the files for any operation other than 
restore, 


The advanced backup options are described on the following pages. 
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Source hard-disk drive 


This option allows you to specify the partition on the hard disk from which 
files will be saved. The partitions recognized by this program range from E 
to K, If a hard disk has fewer partitions, and you select a nonexistant 
partition, a message is displayed on the bottom of the screen in reverse 
video, There is no default value; you must select a partition. 


Destination diskette drive 


This option allows you to specify which diskette drive contains the backup 
diskettes, The option requests that you insert diskettes as needed to save 
all the specified files. 


The drives recognized by this program range from A to D, There is no 
default value; you must select a drive. 


Type of files to save 


This option allows you to specify whether or not to save ALL files or just 
those that have been changed or created since the last back-up procedure. 
The default is to back up all files. However, saving selected files is faster 
and requires less space. 


Backup file specifier 
This option allows you to specify categories of file names to be saved on 
the backup diskette. The names of the files to be saved can be written in 


this entry by using: 


¢ A one to eight-character file name 
e An optional period (.) 
® An optional file type of up to three characters 


If desired, you can also use the following wildcard characters: 


2 Matches any single character 
. Matches any number of any characters, including a blank 
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You can also specify an indirect file. An indirect file contains a list of files 
(one per line) to be saved on the backup diskettes, This is useful if you 
have a long and frequently used list of files. 


To specify an indirect file: 


1. Use the symbol < 
Followed by an optional drive name (A through P) 


Followed by a file name and optional file type. The name of the indi- 
rect file cannot include wildcard characters. However, the file names 
listed in the indirect file can contain wildcards. 


Example: 

<A:LIST.FIL 

If you type an illegal character, a message is displayed at the bottom of the 
screen. If you type a character unintentionally, you can use the delete 
character key to erase the character, 

The default backup file specifier is all files (*.*), 

Backup exclusion file specifier 

This option allows you to specify a category of file names not to be saved 
on the backup diskettes. The names of the files not to be saved can be 
written in this entry by using the wildcard characters described earlier. The 
default is no files. If you type an illegal character, a message is displayed at 


the bottom of the screen. If you type a character unintentionally, you can 
use the delete character key to erase the character. 
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Name for backup diskettes 


The name of the backup diskettes is an eight-character name that you 
choose, This name is stored on each backup diskette in the set. The name 
is also used by the restore and verify programs as a check that the correct 
set of diskettes has been inserted when files are being copied back to the 
hard disk. The default name is BACKUP. To change the name, erase the 
existing name using the delete character key. Then re-type the name. If 
you type an illegal character, a message is displayed at the bottom of the 
screen. If you type a character unintentionally, you can use the delete 
character key to erase the character. 


Exclude System files from backup 


This option allows you to specify whether or not to save files with the 
system attribute that are in the source partition. (Files with system attrib- 
utes are files that you have stored in the system directory. Refer to Chap- 
ter 2 of this guide for more information about attributes and directories.) 
The system files are not often changed so that once you have saved them, 
you can choose not to save them again, The default is NO. 


Exclude Read Only files from backup 


This option allows you to specify whether or not to save files with the Read 
Only attribute that are in the source partition. The default is NO. 


Delete files after backup 


This option allows you to specify whether or not to delete each file from 
the hard disk source partition after the file has been saved onto the backup 
diskettes. This selection can save you time if a large number of files are to 
be permanently saved. In addition, this option eliminates the possibility of 
deleting the wrong files after a permanent back-up procedure. The default 
is NO, 
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Verify files after backup 


This option allows you to specify whether or not to check that the data has 
been correctly copied to the backup diskettes. This feature verifies that the 
data has been properly copied. On the other hand, it takes more time. 
Therefore, if you feel confident about the back-up procedures, select NO 
for this option. The default is NO. 


Get confirmation before deletes 


This option allows you to specify whether or not to require you to “give 
permission” before any data is deleted from the hard disk or backup disket- 
tes. Typical messages remind you that all prior data on the backup disket- 
tes will be destroyed, and that files on the hard disk will be deleted (if 
delete after backup has been selected). You are also prompted before each 
file deletion whether or not to delete that particular file. If you feel confi- 
dent about the operation of the back-up procedure and do not wish to be 
prompted by these messages, select NO for this option. The default is YES. 


Copying Files from Diskettes to the 
Hard Disk 


Option 2 from the BACKUP Main Screen allows you to copy selected files 
from the backup diskettes to a specified partition on the hard disk. This is 
generally done to recover files that were accidentally erased from the hard 
disk. 


To start the restore option, select Option 2 from the BACKUP Main 
Screen shown in Screen 48. When you select this option, you are requested 
to identify the source and destination drives, and the files you want to 
restore. (See Screen 52.) 
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RAINBOW Ba: 


up and Restore Utility (Version 3.0) 


Standard Restore Options 


Sait 
Source diskette drive........+- {mone] ABCD 
Destination hard disk drive.... (none EF GHI IK 


Restore file specifier of 


Brackets surround selected options. 

To point to a line, press the up arrow key or down arrow bey. 

On any line, press ¢Help> for information and instructions. 

When all options are set as desired, press <Do> to begin the restore. 
To see Advanced User Restore Options, press «Next Screen>. 

To quit and return to Main Screen. press «Main Screen (F9)>. 


Screen 52. Standard Restore Options 


NOTE 
The *.* indicates all files. 


To specify the required information: 


1, Press the up or down arrow key to select a line 


2. Press the right arrow key to select an option within a line, or type a 
value on the drawn line 


3. When all selections have been made, press the Do key 
As BACKUP is restoring the files, each file name is displayed on the 
screen. When the program is done, it displays a brief message indicating 


that the restore procedure has completed, and the program returns to the 
BACKUP Main Screen. 
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Advanced Restore Options. The directions at the bottom of the Stan- 
dard Restore Options screen include pressing the Next Screen key. If you 
do this, you are given more options for the restore program as shown in 
screen 53. 


RAINBOW Backup and Restore Utility (Version 1.0) 


Advanced User Restore Options 


“=> 
» (nonel ABCD 


Source diskette drive ‘ 
» (noneD EF GHI JK 


Destination hard disk drive 


Restore file specifier.. 
Restore exclusion file specifier. 
Name of backup diskettes 


Restore over existing files. No {Yes} 
Restore over Read-Only files. No (Yes) 
Restore over system files. No (Yes1 
Verify files after restore (Nol Yes 

Get confirmation before deletes No [Yes] 


To point to @ line, press the up arrow key or down arrow key. 
On any line, press <Help> for information and instructions. 
When all options are set as desired, press <Do> to begin the restore. 
To quit and return to Standard Restore Options, press <Prev Screen>. 
To quit and return to Main Screen, press <Main Screen (F9)>. 


Screen 53. Advanced User Restore Options 
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To specify the required information: 


Press the up or down arrow key to select a line 


2. Press the right arrow key to select an option within a line, or type a 
value on the drawn line 


3. When all information has been specified, press the Do key 
As BACKUP is restoring the files, each file name is displayed on the 
screen, When the program is done, it displays a brief message indicating 


that the restore procedure has completed, and the program returns to the 
BACKUP Main Screen. 


These options are similar to those for the backup options, except for three, 
which are described on the next page. 
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Restore over existing files 


This option allows you to specify whether or not to restore files from the 
backup diskettes even if a file of the same name already exists on the hard 
disk. If the file already exists on the hard disk, it is deleted and the file 
from the diskette is written onto the hard disk. 


The option is useful if you wish to restore a few files that were inadver- 
tently deleted. The default is YES. 


Restore over Read Only files 


This option allows you to specify whether or not to restore files that have a 
Read Only protection attribute from the backup diskettes even if a file of 
the same name already exists on the hard disk. If the file already exists on 
the hard disk, it is deleted and the file from the diskette is written onto the 
hard disk, 


This option, in effect, allows the Restore utility to override the Read Only 
attribute. The default is YES. 


Restore over system files 

This option allows you to specify whether or not to restore system files 
from the backup diskettes even if a file of the same name already exists on 
the hard disk. If the file already exists on the hard disk, it is deleted and 
the file from the diskette is written onto the hard disk. 


This option is useful if you wish to restore all application files to a previous 
state. The default is YES. 
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Comparing Files after Copying to Hard 
Disk 


Option 3 of the BACKUP program allows you to compare specified files on 
the backup diskettes with the corresponding files on the hard disk, This 
option can be used to indicate any changes that have been made since a file 
was last saved, The verify option is useful as a check that you have the 
latest copy of any given file, as well as a check to be sure you have saved 
the file on diskettes, * 


To start the verify option, select Option 3 from the BACKUP Main Screen 
shown in Screen 48, When you select this option, you are requested to 
identify the diskette and hard disk drives, and the files you want to verify, 
(See Screen 54.) 


RAINBOW Backup and Restore Utility (Version 1.09 


Standard Verify Options 


Compare diskette drive........5- (none) ABCD 
Compare hard disk drive,.......++ [none EF GHI UK 
Compare file specifier.....sesee- ed 


Brackets surround selected options. 
To point to line, press the up arrow key or down arrow key. 

On any line, press <Help> for information and instructions. 

When all options are set as desired, press ¢Do> to begin the verify. 
To see Advanced User Verify Options, press «Next Screens. 

To quit and return to Main Screen, press «Main Screen (F9)>. 


Screen 54. Standard Verify Options 
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To specify the required information: 


1. Press the up or down arrow key to select a line 


2, Press the right arrow key to select an option within a line, or type a 
value on the drawn line 


3. Then press the Do key 
As BACKUP verifies each file, the file name is displayed on the screen. 
When the program is done, you see a brief message indicating that the 


verify procedure has completed, and the program returns to the Main 
Screen, 


The verify options are similar to the backup and restore options as 
described on preceding pages. 


Listing File Names on Backup Diskettes 


Option 4 of the BACKUP program allows you to list the names of all files 
that were saved on a set of backup diskettes, 


To start the directory option, select Option 4 from the BACKUP Main 


Screen shown in Screen 48. When you select this option, you see the 
options as shown in Screen 55. 
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RAINBOW Backup and Restore Utility (Version 1.02 


Directory Options 


— > 


Source diskette drive (nonel A BC D 


Brackets surround selected options. 

To point to a line, press the up arrow bey or down arrow key. 

On any line, press ¢Help> for information and instructions. 

When all options are set as desired, press ¢Do> to read the directory. 
To quit and return to Main Screen, press <Main Screen (F9)>. 


Screen 55. Directory Options 


After you specify a drive, the program displays information about backup 
diskettes and the files on these diskettes. 


As BACKUP reads each diskette, you are requested to insert another back- 


up diskette from the set into the source drive until the complete directory 
is read. 
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A Short Cut to the Backup and 
Restore Options 


If you know which of the first four options you want to run without display- 
ing the Main Screen, you can type any of the following commands: 


NOTE 

The following examples assume drive A to be the 

active drive. 
A>BACKUP (BACKUP) p:ffilename.typ} TO dev: C/ALL] L/CHANGED) Caaum) 
A>BACKUP RESTORE p: FROM devil filename.typ) 


A>BACKUP VERIFY p: WITH devil filename, typ] CRewm ) 


A>BACKUP DIRECTORY drv: Caewm) 


Where: 
p: Is a hard disk partition (E through K) 
drv: Is a diskette drive (A through D) 


{filename.typ] Is an optional file specifier or indirect file (explained later 
in this section) 


[/ALL] Is an optional specification to back up all files 


|/CHANGED] Is an optional specification to back up only the files that 
have changed since the last backup. 


Leaving the BACKUP Program 


Option 6 from the BACKUP Main Screen allows you to leave the BACKUP. 
program, and return to the Utility Program Main Screen. To select Option 
6, press the down arrow key until the displayed arrow reaches the sixth 
option, or type the number 6. Then press the Do key. 


240 


Advanced Hard Disk Procedures 


Section 4 
Recovering from Hard Disk Problems 


This section describes problems you might encounter while initializing or 
repartitioning the hard disk, or while running programs on the disk. 


Detecting Operation Problems 


Segments of storage space are called sectors. There are two instances 
when sector problems may be detected during normal operation: 


1. When reading a previously written file 
2. When a new file is being written 


If a problem occurs, the program cannot read or cannot write the file, and 
the following message is displayed: 


Read error on drive drv:, track nn, sector nn 
or 


Write error on drv:, track nn, sector nn 


Recovering from an Operation 
Problem 


When you see the READ ERROR or WRITE ERROR message, run the 
program called RECOVER, found on the utility diskette. The RECOVER 
program assigns an alternate sector and copies the data into the good sec- 
tor, ignoring the problem. The program then informs you that the file is 
now readable. The file, however, may contain modified data or data may 
have been lost. 
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RECOVER requires that you specify the hard disk drive name where the 
file is located. For example, 


A>RECOVER Es (Reum) 
If you type: 
A>RECOVER (Remm) 


you are prompted for the drive name where the file is located. 


Detecting Initialization or 
Repartitioning Problems 


During the initialization or repartitioning process, problems may be found 
on sectors, If problems are found on sectors, alternate sectors are automat- 
ically assigned, and the problem sectors are ignored. 

If you see a message that begins with: 


FATAL ERROR 


The entire disk is unusable. However, if you see a message that begins 
with: 


ERROR IN PARTITION drv: 


only the specified partition is unusable, and you can continue with other 
partitions. 


Recovering from an Installation 
Problem 


To run the diagnostic test and re-initialize the disk if you have encountered 


frequent problems, first, return to the Main Screen on the utility diskette, 
and select Option 4. 
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Option 4: Run the hard disk diagnostic 


This option runs the same diagnostic test as you ran to initialize the disk 
(Option 1, described in the Rainbow Winchester Disk Option Installation 
Guide). However, Option 4 should be run if a problem was detected while 
running Option 1. Unlike Option 1, Option 4 displays detailed messages as 
it runs eight subtests. As each subtest runs, the program displays either: 


PASSED 
or 
FAILED 


Screen 56 shows the end of a diagnostic test during which no problems 
were detected. 


RAINBOW Hard Disk Utility Program (Version 0.16) 


PASS 0000 
READ ALL SECTORS PASSED 
SUBTEST #7: WRITE SECTORS TEST 
IMPLIED SEEKCWRITED PASSED 
BASIC WRITE TEST 1 PASSED 
BASIC WRITE TEST 2 PASSED 
BASIC WRITE TEST 3 PASSED 
SUBTEST #8: WRITE FORMAT TESTS PASSED 


*** DIAGNOSTIC COMPLETE *** 


PRESS <Return> TO RETURN TO MAIN MENU 


Screen 56. End of a Diagnostic Test 
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If Option 4 encounters new bad sectors during initialization, when Option 4 
finishes, you see the following message: 


n NEW BAD SECTORS DETECTED 
SELECT THE RE-INITITALIZE OPTION 


If you see this message, return to the Main Screen, back up your files, then — 
run Option 5 to re-initialize the disk. 


Option 5: Re-initialize the hard disk 


This procedure is the same as option 1 except it does not run the diagnos- 
tic test. 


You select Option 5 if problems have been found on partitions after you run 
the diagnostic test (Option 4). Re-initialization is like beginning again with a 
new disk. If any information was previously stored on the disk, it will be 
erased. 


If the number of bad sectors within a partition is less than the maximum 
allowed, the bad sectors are recorded in an internal table and are no longer 
used by the operating system. You can then restore the files back to the 
hard disk, minus the bad sectors. 


If the number of bad sectors exceeds the maximum allowed, the partition 
cannot be used, and the following message is displayed: 


ERROR IN PARTITION dev: 
Too many bad sectors 
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Diskeites 


Flexible diskettes, when used with care, are remarkably durable and reliable 
storage devices, Any given portion of a diskette’s surface can be read and 
written upon millions of times before the oxide film that holds the data 
begins to wear too thin to consistently hold data. Moreover, flexible diskettes 
routinely pass, without a single problem, diagnostic tests. These tests 

fill the diskettes’ tracks with data, which is checked, changed, and rewritten 
in worst-case format, over and over. 


In spite of their ruggedness and reliability, flexible diskettes (sometimes 
called “floppies”) have acquired a somewhat poor reputation in data 
processing circles. 


There are several reasons for this reputation. For example, diskettes are 
often placed on top of video terminals where they are exposed to heat and 
magnetic fields, placed beneath coffee cups and cold drink cans, and even 
left on the floor without their protective envelopes. 


In spite of such treatment, many diskettes continue to work for months or 


years at a time. However, to avoid potential disaster, observe the following 
precautions. 
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Storing Diskettes 


Keep flexible diskettes in close-fitting, dust-tight boxes (like those they 
are packaged in when you buy them ten at a time). 


Store these boxes in rooms with consistent temperature, humidity, and 
cleanliness. 


Handling Diskettes 


Follow the tips below when handling diskettes. 
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Avoid bending the diskettes. The “flexibility” of flexible diskettes is an 
accident of their design, not a goal. They will bend, but when bent 
their covers tend to crease or warp in ways that cause wear and 
binding when the drives rotate the diskette inside. Insert diskettes 
gently into their drives. 


Never allow your fingers to touch the diskette data surface (that is, 
the shiny, usually brown or black surface inside the black cover). Body 
oils cause the drive read/write heads (small electromagnets used to 
read or write information) to behave erratically, usually at the cost of 
data. 


Always return diskettes to their protective paper envelopes, even if 
you expect to use them again in a few seconds. One piece of grit on a 
diskette picked up from a desk top can wipe out a week’s work. 


Keep diskettes far away from magnets. Magnets are often used to 
hold notes and pictures to metal surfaces. These handy items can 
damage diskettes. 


The best place to store diskettes, even temporarily, is in their storage 
boxes. Otherwise, keep them in their protective paper envelopes and 
never lay anything on top of them. Once you coyer a diskette with a 
memo, the next thing you lay down will inevitably be a magnetized 
paperweight, stapler, or a key ring. 


Diskettes 


Using Diskettes 


e Always identify your diskettes with the self-sticking labels, (You can 
always ask the computer to tell you what is on the diskette.) If you fill 
out these labels after they are applied to the diskette cover, use only 
felt-tip pens because they require minimum pressure. Never use a 
ball-point pen or pencil. They can seriously damage both the diskette 
cover and the diskette inside. 


If you place a new label on a diskette, be sure to gently peel off the 
old label first. Placing labels on top of labels can cause the diskette to 
be seated improperly in a drive. 


* Never allow diskettes to become so full that you risk running out of 
space while trying to write data to them, Leave some free space on 
your data diskettes. 


e When running application programs that write data to diskettes, do not 
exchange one diskette for another except when the program tells you 
to do so or has finished executing. Some programs open files and leave 
them open until all the required data has been entered and acted upon. 
You almost certainly will have trouble if you exchange diskettes in the 
middle of such an operation. Reinitialize the operating system by typ- 
ing Ctrl/C after inserting a diskette into a drive that has just been 
used for writing data. This will ensure that the operating system has 
initialized all its internal diskette pointers. 


© Do not turn the computer's power on or off when a diskette is 
inserted into any drive. 


Diskette Back-up Procedures 


These procedures involve making copies of any edited diskettes. It is impor- 
tant to make copies of all diskettes because the originals can be lost or 
damaged. For example, sliding a diskette in and out of its jacket or a drive 
can wear it out. 


Follow these tips and protect your work. 


* Make copies of original diskettes, Label the original “master’’ and 
store it. You might want to make two copies of the original. 
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® Set up a diskette rotation method. Use five diskettes. At the close of 
day one, copy diskette work onto day two's diskette. At the close of 
day two, copy work onto day three’s diskette. Label diskettes with the 
numbers, actual dates, or days of the week. 


¢ Take diskettes out of use after six months of rotation. 


Above all “better safe than sorry.” Months of work can be lost due to 
worn-out or damaged diskettes. 


Diskettes and Files 


The CP/M-86/80 operating system deals with a wide range of information 
including programs, text, and data. Information is organized in the form of 
files, and the files are stored on diskettes. File names distinguish electronic 
files much the same way as labels on file folders distinguish paper files in a 
cabinet. 


Storing Information on Diskettes 


The computer stores and retrieves files by referring to tracks and sectors 
on a diskette (see Figure 12). 
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TRACK O 
TRACK 1 


SECTOR 2 


SECTOR 1 


RIM OF 
SURFACE 


NOTE: THERE IS NO SECTOR O 


PLASTIC COVER 


THIN MYLAR DISKETTE COATED | ®_,7 
WITH MAGNETIC MATERIAL / 
(RECORDING SURFACE) / 


INNER EDGE OF 
PLASTIC COVER 


DRIVE SPINDLE 
ACCESS HOLE” 


ACCESS HOLE FOR DISKETTE 
READ/WRITE HEAD 


* ROTATING SPINDLE ENTERS THIS HOLE, 
GRABS DISKETTE, AND SPINS IT. 


Figure 12. Tracks and Sectors on a diskette 
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Rainbow diskettes have 80 tracks, (numbered 0-79); each track is com- 
posed of ten sectors. Sectors store blocks of “‘bytes;”’ each byte represents 
one character such as a letter, a digit, or a symbol. Because each sector 
has a unique location on a diskette, the computer can find a particular 
sector on a particular track and store information in it or retrieve informa- 
tion from it. 


The amount of information you can store on a diskette depends on the 
diskette’s “‘density."" The Rainbow's double density diskettes can hold twice 
as much information as single density diskettes. You can store about 150 
pages of typewritten text on one diskette assuming 54 lines per page and 
65 characters per line. 


Protecting Information on Diskettes 


You can protect the data on a diskette from being accidentally deleted by 
applying a self-sticking write-protect tab onto the diskette’s write-protect 
notch, (See Figure 13). 


}] wRiTe- 
PROTECT 
TAB 


Figure 13. Applying a Write-Protect Tab 
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This tab prevents the computer from writing on the diskette, You can 
remoye the write-protect tab by peeling it off the diskette when you want 
the computer to write on it. 


NOTE 


You can purchase write-protect tabs at any com- 
puter store. 
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What is in this Appendix 


This appendix lists the messages that can be displayed while you are start- 
ing or using the CP/M-86/80 operating system. 


As a general rule, if a message(s) is displayed, RETRY the command or 
procedure a few times. Messages are most often due to mistyping a com- 
mand, or omitting part of a command line. If the message persists, refer to 
the list of messages and possible corrective action. Peform the suggested 
corrective action and then RETRY the procedure. 

If you see a message that starts with 


See Owner’s Manual - MESSAGE nn - 


Consult the Rainbow Owner's Manual. 
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If a message is displayed while you are using an application, refer to the 
user’s guide supplied with that program. For a fast reference to the operat- 
ing system messages, Table 14 alphabetically lists each message in this 
appendix, the source of the message, and the page where you can find it. 


NOTE 
Under the “Source” column, O.S, refers to the 
operating system. 


Table 14. List of Messages and Their Source 


Message Source Page 
Aborted OS. 262 
Bad Directory on dry: STAT 263 
BDOS Err on A: FILE R/O Os. 263 
Type any key to exit. 

BDOS Err on A: R/O OS. 264 
Type any key to exit. 

BDOS Err on A: SELECT OS. 264 
Type any key to exit. 

Cannot find RED MASTER DISKETTE RED 265 
Cannot load .COM file Os. 265 
Cannot run .COM file on 64K system IOS: 265 
Command too long SUBMIT 266 
DESTINATION DISKETTE FORMAT IS. DISKCOPY 266 
INCORRECT 

DESTINATION DISKETTE IS NOT RX50K DISKCOPY 266 
FORMAT 

DESTINATION IS R/O, DELETE (Y/N)? PIP 266 
Drive not ready — drv: O.S. 267 
DRIVE NOT READY - DOOR OPEN OR FORMAT 268 
NO DISKETTE IN DRIVE 

DRIVE NOT READY. Try another? (Y/N) DISKCOPY 269 
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Table 14. List of Messages and Their Source (cont.) 


Message 


Source 


DRIVE SPEED OUT OF RANGE - DRIVE 
CANNOT BE USED FOR FORMATTING 


Drive write-protected — dry: 


ERROR: BAD PARAMETER 


ERROR: CLOSE FILE - [drv:filename.typ] 


ERROR: DISKETTE READ - 
{drv:filename.typ] 


ERROR: DISKETTE WRITE - 
(drv:filename.typ]| 


ERROR: FILE NOT FOUND - 
[drv:filename.typ] 


ERROR: HEX RECORD CHECKSUM - 
{drv:filename.typ]} 


ERROR IN PARTITION drv: 
Initialization data could not be written 


ERROR IN PARTITION drv: 
Too many bad sectors 


ERROR: INVALID DESTINATION 


ERROR: INVALID FORMAT - 
ldrv:filename.typ] 


ERROR; INVALID HEX DIGIT - 
[drv:filename.typ]} 


ERROR: INVALID SEPARATOR - 
{drv:filename.typ] 


ERROR: INVALID SOURCE 
ERROR: INVALID USER NUMBER 


ERROR: NO DIRECTORY SPACE - 
[drv:filename.typ] 


ERROR: QUIT NOT FOUND 
ERROR: START NOT FOUND 


FORMAT 


O.S. 
PIP 
PIP 
PIP 


PIP 


PIP 


PIP 


hard disk utility prog. 


hard disk utility prog. 


PIP 
PIP 


PIP 


PIP 


PIP 
PIP 
PIP 


PIP 
PIP 
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Table 14. List of Messages and Their Source (cont.) 


Message 

ERROR; UNEXPECTED END OF HEX 
FILE - [drv:filename.typ] 

ERROR: USER ABORTED 

ERROR; VERIFY - |drv:filename.typ] 
Error on Line nnn Diskette Write Error 
Error on Line nnn Parameter Error 
Error on Line nnn No ‘SUB’ File Present 


FATAL ERROR 
Hardware failure detected during testing 


FATAL ERROR 
Hard disk does not respond 


FATAL ERROR 
Initialization data could not be read from 
hard disk 


FATAL ERROR 
Initialization data could not be written on 
hard disk 


FATAL ERROR 
No hard disk diagnostic program 


FATAL ERROR 
No pre-boot program 


FATAL ERROR 
No secondary boot program 


FATAL ERROR 
Programming error occurred 


FATAL ERROR 
Secondary boot program is too big 


FILE EXISTS 
File Not Found 


Hard disk option is not connected 


Source 


PIP 


PIP 
PIP 
SUBMIT 
SUBMIT 
SUBMIT 


hard disk utility prog. 


hard disk utility prog. 


hard disk utility prog, 


hard disk utility prog. 


hard disk utility prog. 


hard disk utility prog. 


hard disk utility prog. 


hard disk utility prog. 


hard disk utility prog. 


REN 
STAT 


hard disk utility prog. 


Page 
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Table 14, List of Messages and Their Source (cont.) 


Message Source Page 

Invalid Assignment STAT 284 

Invalid Assignment STAT 284 

Use: STAT drv:=RO 

Invalid Assignment , STAT 285 

Use: STAT drv-filename.typ [size] [ro] [rw] 

[sys] or [dir] 

MEMORY NOT AVAILABLE OS. 286 

nn? USER 286 

NO FILE DIR 286 

NON-SYSTEM FILE(S) EXIST DIRS 287 

Read error TYPE 287 

Read error on drive dry:, track nn, sector nn OS. 288 

READ ERROR. Try another? (Y/N) DISKCOPY 289 
~ READ ERROR - UNABLE TO READ ALL FORMAT 289 

DISK SECTORS 

RED ERROR: Bad syntax on line RED 290 

‘Try RED NEWNAME |=] [OLDNAME] [/W] 

RED ERROR: Cannot edit read-only file RED 290 

RED ERROR: Illegal character on line, RED 290 

do not use, <>;?[]* 

RED ERROR: PLEASE ENTER “RED” RED 291 

FOLLOWED BY A FILE NAME 

Rename error; File “filename.ext” already MAINT 29) 

exists 

Seek error on drive drv:, track nn Os. 291 

SORRY CANNOT OPEN DOCUMENT RED 293 

SOURCE DISKETTE FORMAT IS DISKCOPY 293 

INCORRECT 

SOURCE DISKETTE IS NOT RX50K DISKCOPY 293 

FORMAT 
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Table 14. List of Messages and Their Source (cont.) 


Message Source Page 
SYSTEM FILE(S) EXIST DIR 293 
The file CPM.SYS not found on this disk OS. 294 
Do a system reset with a new disk 

The file Z230CNF.SYS cannot be loaded OS. 294 
The file Z30CNF.SYS cannot be found on OS. 295 
the System Disk 

The start of partition drv: was moved hard disk utility prog. 295 
Topic Not Found HELP 295 
WARNING: Files may not be intact on drive 0.S. 296 
drv: 

WARNING: The hard disk is not formatted OS. 296 
or not partitioned 

WRITE ERROR: CANNOT FORMAT FORMAT 297 
DISKETTE 

Write error on drive drv:, track nn, sector nn O.S, 297 
WRITE ERROR, Try another? (Y/N) DISKCOPY 298 
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Conventions Used 
Table 15 lists the conventions used in the discussion of the messages. 


Table 15. Message Conventions 


Convention Meaning 

drv or drv: Drive name (A through D, or E through H for hard 
disk) 

an Track or sector number on a diskette; or a user num- 
ber 

nnn Line number in a .SUB file (a file you create, contain- 
ing CP/M-86/80 commands, used with SUBMIT) 

filename File name 

atyp File type 

filespec File specification, including the drive name, file name, 
and file type 


When you are instructed to reinitialize the operating system, hold down the 
control key while you press the C key. Do this directly after the prompt. 
This action is symbolized by: 


Cui 


(If you have typed a command after the prompt, type Ctrl/X to erase the 
line back to the prompt.) Depending on the program being run when the 
message is displayed, you may have to type Ctrl/C two or three times to 
reinitialize the operating system. The indications that the operating system 
is being reinitialized are: 


© The drive makes ‘‘clicking’’ sounds. 


© The lights beside one or more drives turn on momentarily, 
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Messages 


The following are the messages that can be displayed while using the 
CP/M-86/80 operating system. The message is printed first in large type, 
followed by what it means and what to do about it. 


Aborted 


Meaning. This message can be displayed if you stop a transient program, 
such as PIP. Refer to Chapter 2 of this guide for more information about 
transient programs. 


If a CP/M-86/80 program cannot be loaded or run properly on a Rainbow 
computer that has additional memory, possibly the additional memory is not 
working properly. 


Action. Try running the program again by retyping the command, 


If the program still cannot be loaded or run properly, run the extended self- 
test program to check the optional memory. To run this test: 
1. Remove the CP/M-86/80 application program diskette from the drive. 


2. Reset the computer by pressing the Set-Up key followed by the 
Ctrl/Set-Up keys. Be sure the correct memory size is saved. 


3. Insert a Rainbow diskette into drive A; if desired, you can insert a 
system diskette, 


4, Press the S key in response to the Main System Menu. 


If the self-test program detects a problem with the additional memory, the 
following message is displayed: 


See Owner’s Manual - MESSAGE 27 - Memory Board 
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If this message is displayed, turn the computer off and then on again. If the 
problem persists after several retries, replace the optional memory by: 


e Reporting the problem to your vendor, 


* Reporting the problem to the DIGITAL Customer Help Line. For the 
phone number of the office nearest you, look on the bottom of your 
keyboard or refer to Appendix C of this guide. 


© Ordering the part'and installing it yourself if you have the Rainbow 
100 User’s Service Guide. This guide is not included in the Rainbow 
System Kit. 


Bad Directory on drv: 
User nn filespec 


Meaning. This message can be displayed if STAT finds more than one 
file sharing the same portion of the diskette. Refer to Chapter 2 of this 
guide for more information about the STAT command. The message is 
followed by a list of file specifications, 


Action. Retry the procedure or reset the computer and then retry the 
procedure. 


If the problem persists: 


1. Erase the file(s) listed after the message. 
2. Re-initialize the operating system. 
3. Retry the procedure. 


BDOS Err on A: File R/O 
Type any key fo exit 


Meaning. This message can occur if the specified file is assigned the 
Read Only Attribute. 


You may also see this message if you attempt to erase a diskette using the 
ERA command, and the diskette is assigned the Read Only Attribute. 
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Action. 


1. Exit the program. 


2. Assign the file the Read Write Attribute using the STAT or MAINT 
commands. 


3. Retry the procedure. 


Refer to Chapter 2 of this guide for more information about attributes and 
the ERA and MAINT commands. 


BDOS Err on A: R/O 
Type any key to exit 


Meaning. This message can be displayed if you have assigned a Read 
Only attribute, using STAT, to protect your files. Refer to Chapter 2 of 
this guide for more information about attributes and the STAT command. 


Action. 


1. Exit the program. 


Assign the drive the Read Write Attribute using the STAT command 
if the specified drive has been assigned the Read Only Attribute. This 
message does not mean that the diskette has a write-protect tab on it. 


S 


3. Then, retry the procedure. 


BDOS Err on A; Select 
Type any key to exit 


Meaning. This message is usually displayed if you select a nonexistent 
drive. 


Action. 


1. Exit the program. 
2. Select an existing drive if you selected a nonexistent drive. 
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3. Insert a Rainbow diskette into the drive if the diskette is formatted 
improperly. 

4, Retry the procedure. 
Cannot find RED MASTER DISKETTE 
Meaning. This message can be displayed if you try to use RED from a 
drive other than the active drive. Refer to Chapter 3 of this guide for more 
information about the RED editor. 
Action. Change diskette drives or use PIP to copy RED onto the diskette 


in the active drive, Refer to Chapter 2 of this guide for more information 
about the PIP command. 


Cannot load .COM file 


Meaning. This message can be displayed if there is not enough memory 
to store a CP/M-80 program. 


Action. Type: 


Cowe ) 
to re-initialize the operating system and then retry the procedure. 

If the problem persists, the CP/M-80 program may be too large to store in 
memory. Check your application program’s documentation for the size of 


the program. The computer’s transient program area is approximately 60K 
bytes of memory on a computer with 128K bytes or more of memory. 


Cannot run .COM file on 64K system 


Meaning. This message can occur if you try to run a CP/M-80 base 
program on a computer with 64k bytes of memory. 


Action. Run the program on a computer with 128K bytes or more of 
memory. 
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Command too long 

Meaning. This message can be displayed if SUBMIT finds a command in 
the .SUB file that exceeds 125 characters. Refer to Chapter 2 of this guide 
for more information about the SUBMIT command. 


Action. 


1. Edit the .SUB file. 
2. Shorten the command. 
3. Retry the procedure. 


DESTINATION DISKETTE IS INCORRECT 

Meaning. This message can occur if the DISKCOPY program cannot 
determine the type of diskette in the destination drive. Refer to Chapter 2 
of this guide for more information about DISKCOPY. 


Action. Replace the diskette in the destination drive. 


DESTINATION DISKETTE IS NOT RX50 FORMAT 

Meaning. This message can occur while using DISKCOPY if you have a 
diskette with the wrong format in the destination drive. Refer to Chapter 2 
of this guide for more information about the DISKCOPY program. 


Action. Replace the diskette with one that has the proper format, or for- 
mat the diskette currently in the drive. The re-run DISKCOPY. 


DESTINATION IS R/O, DELETE (Y/N)? 
Meaning. This message can be displayed if PIP tries to delete an existing 


file that has the Read Only Attribute. Refer to Chapter 2 of this guide for 
more information about the PIP command. 
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Action. 


Type Y to delete existing file. 
Type N to stop the copy, 


Drive not ready — drv: 

Type a number followed by Return 
1. Retry operation. 

2. Cancel program. 

3. Ignore error and continue. 

4. Proceed, returning error. 


=> 


Meaning. This message can occur if: 


The drive door is open 
There is no diskette in the drive, or the diskette is inserted 
incorrectly 


The specified drive does not exist (for example, if you specify drives C 
or D and you do not have a computer with four drives. 


Action. Select one of the options by typing a number and pressing the 
Return key. 


ike 


If you choose to retry the procedure, the operating system repeats the 
failed disk operation. If the conditions causing the message have 
cleared up, the operating system continues as though no message had 
occurred. If the conditions causing the message still exist, the message 
will be repeated. 

If you choose to cancel the program, the operating system stops the 
current command or program process and returns you to the system 
prompt. If the operating system was in the process of writing files on 
the diskette when the message occurred, the files may be incomplete. 
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3. If you choose to ignore the error, the operating system continues with 
the command or program as if no error had occurred. Any data read 
or written after this will probably be incorrect and you should check 
the files when done. 


4. If you choose to proceed, returning the error, the operating system 
returns the error condition to the command or program. The program 
in turn discontinues processing and the result is identical to option 2. 
Some applications may provide additional actions or messages. 


If you return to the operating system: 


* Close the drive door if it is open 

© Insert a diskette into the drive 

* Reinsert the diskette correctly into the drive if it is upside-down 

* Reinsert the diskette correctly into the drive if it is not inserted fully 
* Specify an existing drive name 

¢ Then retry the procedure 


DRIVE NOT READY - DOOR OPEN OR NO DISKETTE IN DRIVE 
Meaning. This indicates either that: 


© The drive door is open 


* There is no diskette in the drive, or the diskette is inserted 
incorrectly 


© The specified drive does not exist (for example, if you specify drives C 
or D and you do not have a computer with four drives.) 


Action. 


* Close the drive door if it is open 
* Insert a diskette into the drive 
* Reinsert the diskette correctly into the drive if it is upside-down 
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© Reinsert the diskette correctly into the drive if it is not inserted fully 
e Specify an existing drive name 


If you did not select the correct drive: 
1. Type: 
Cui/ic 


to return to the operating system prompt. 
2. Retry the procedure selecting the correct drive. 


DRIVE NOT READY. Try another? (Y/N) 
Meaning. This message can be displayed by DISKCOPY if: 


* There is no diskette in the drive. 
© The diskette in the drive is upside-down. 
e The diskette is not inserted fully in the drive. 


The drive door is not closed. 


Refer to Chapter 2 of this guide for more information about the DISKCOPY 
command. 


Action. 


¢ Insert a diskette into the drive. 
¢ Reinsert the diskette into the drive correctly. 
* Close the drive door. 


Then, press the Y key to retry the procedure. 


If you want to exit the program, press the N key and then the Exit key. 
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DRIVE SPEED OUT OF RANGE - DRIVE 
CANNOT BE USED FOR FORMATTING 


Meaning. This message can occur while formatting a diskette when 
tracks are being written on the diskette. If this message is displayed, dis- 
kettes formatted on that drive may be unusable on another drive. 


You also see this message if the diskette drive is faulty, 


Action. Select another drive for formatting. If the message persists 
replace the drive by: 


e Reporting the problem to your vendor, 

e Reporting the problem to the DIGITAL Customer Help Line. For the 
phone number of the office nearest you, look on the bottom of your 
keyboard or refer to Appendix C of this guide. 

© Ordering the part and installing it yourself if you have the Rainbow 
100 User's Service Guide. This guide is not included in the Rainbow 
System Kit, 


Drive write-protected — drv: 

Type a number followed by Return: 

1. Retry option. 

2. Cancel program execution. 

3. Ignore error. 

4, Proceed, returning error. 
==> 


Meaning. This message can be displayed if the operating system tries to 
write onto a diskette that has a write-protect tab on it. 
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Action. Select one of the options by typing a number and pressing the 
Return key, 


1. If you choose to retry the procedure, the operating system repeats the 
failed disk operation. If the conditions causing the message have 
cleared up, the operating system continues as though no message had 
occurred. If the conditions causing the message still exist, the message 
will be repeated. 


2. If you choose to cancel the program, the operating system stops the 
current command or program process and returns you to the system 
prompt. If the operating system was in the process of writing files on 
the diskette when the message occurred, the files may be incomplete. 


3. If you choose to ignore the error, the operating system continues with 
the command or program as if no error had occurred. Any data read 
or written after this will probably be incorrect and you should check 
the files when done. 


4. If you choose to proceed, returning the error, the operating system 
returns the error condition to the command or program. The program 
in turn discontinues processing and the result is identical to option 2. 
Some applications may provide additional actions or messages. 


If you return to the operating system: 


1. Remove the diskette from the drive. 
2. Remove the write-protect tab from the write-protect notch. 
3. Retry the operation. 


ERROR: BAD PARAMETER 

Meaning. This message can be displayed if PIP finds an illegal parameter 
included in the command. Refer to Chapter 2 of this guide for more infor- 
mation about the PIP command. 


Action. Retype the command using a valid parameter. 
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ERROR: CLOSE FILE - [drv:filename.typ] 


Meaning. This message can be displayed if PIP cannot close the specified 
output file because: 


e The diskette has a write-protect tab on it. 
e The diskette resides in a drive with the Read Only Attribute. 


Refer to Chapter 2 of this guide for more information about the PIP 
command. 


Action. 
1. Remove the write-protect tab from the diskette and reinsert it into 


the drive if you want to write the file onto the diskette. 


2. Assign the drive the Read Write Attribute by typing Ctrl/C or using 
STAT if you want to write the file onto the diskette. 


3. Then, retype the command. 


Refer to Chapter 2 of this guide for more information about the STAT 
command, 


ERROR: DISKETTE READ - [drv:filename.typ] 


Meaning. This message can be displayed if PIP cannot read the specified 
input file properly. This message is usually displayed because the file con- 
tains an unexpected end-of-file marker. An end-of-file marker is a code 
inserted into every text file that indicates where the text ends, 


Refer to Chapter 2 of this guide for more information about the PIP 
command, 


Action. Use a debugging program to delete the end-of-file marker. Then 
retype the command. 
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ERROR: DISKETTE WRITE - [drv:filename.typ] 


Meaning. This message can be displayed if PIP cannot write the specified 
output file onto the diskette. This. message is usually displayed because the 
diskette is full of files. 


Refer to Chapter 2 of this guide for more information about the PIP 
command. 


Action. Insert a diskette with free space on it to store the file or erase 
unnecessary files from the full diskette. Then, retype the command. 


ERROR: FILE NOT FOUND - [drv:filename.typ] 
Meaning. This message can be displayed by PIP if: 


* The file is not found on the specified diskette. 

© The file name or file type is mistyped. 

* The period between the file name and the file type is omitted. 
© The wrong drive is specified. 

¢ The file type is omitted. 

© Too few wildcards are used. 


* The file being copied has the System Attribute and the [R] parameter 
is not used, 


© The file is stored in another user number. 


Refer to Chapter 2 of this guide for more information about the PIP 
command, 


Action. 


© Insert the diskette containing the file and retype the command. 
® Retype the command including the correct file name and file type. 


® Retype the command including the period between the file name and 
file type. 
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® Retype the command including the correct drive. 

e Retype the command including the file type. 

e Retype the command including enough wildcards. 

® Retype the command using the [R] parameter 

* Specify the correct user number from which to copy. 


ERROR: HEX RECORD CHECKSUM - [drv:filename.typ] 


Meaning. This message can be displayed if PIP finds a hexadecimal 
checksum error during a hexadecimal file transfer while using the [H] 
parameter. (A checksum is a method of verifying that the hexadecimal file 
is copied correctly.) 


Refer to Chapter 2 of this guide for more information about the PIP 
command. 


Action. Repeat the procedure that generated the hexadecimal file, and 
retype the command. 


ERROR IN PARTITION drv: 
Initialization data could not be written 


Meaning. The operating system requires certain data to be written to the 
first two sectors of the partition. This message can occur if some of that 
data could not be written for any reason. 


Refer to Chapter 6 of this guide for more information about partitioning a 
hard disk. 


Action. Press the Resume key to advance to other partitions; others are 
still usable. 


274 


Operating System Messages 
ERROR IN PARTITION drv: 
Too many bad sectors 


Meaning. This message can occur if the hard disk partition contains more 
bad sectors than there are remaining alternate sectors. 


Refer to Chapter 6 of this guide for more information about partitions on a 
hard disk. 


Action. Press the Resume key to advance to other partitions; others are 
still usable. 


ERROR: INVALID DESTINATION 

Meaning. This message can be displayed if PIP finds an invalid destina- 
tion in the command. This message usually is displayed because an input 
device is specified as a destination, 


Refer to Chapter 2 of this guide for more information about the PIP 
command. 


Action. Retype the command with a valid destination. 


ERROR: INVALID FORMAT - [drv:filename.typ] 


Meaning. This message can be displayed if PIP finds an invalid format in 
the command. This message usually is displayed because: 
© There is a blank space between the file specification and a parameter, 
e The command, PIP, was typed while in program mode. 
e The command line was typed with spelling errors. 
e An incomplete command line was typed. 


Refer to Chapter 2 of this guide for more information about the PIP 
command. 


Action. Retype the command correctly. 
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ERROR: INVALID HEX DIGIT - [drv:filename.typ] 
Meaning. This message can be displayed if PIP finds an illegal hex- 
adecimal digit while reading a hexadecimal file while using the [H] 


parameter. 


Refer to Chapter 2 of this guide for more information about the PIP 
command. 


Action. Repeat the procedure that generated the hexadecimal file, and 
retype the command, 


ERROR: INVALID SEPARATOR - [drv:filename.typ] 
Meaning. This message can be displayed if: 


e PIP finds an invalid character between input file names. 
e The file name or file type contains an illegal character. 


Refer to Chapter 2 of this guide for more information about the PIP 
command, 


Action. Retype the command using a comma to separate two or more 
input files. 


ERROR: INVALID SOURCE 
Meaning. This message can be displayed if PIP finds an invalid source. 
This message usually is displayed because an output device is specified as a 


source, 


Refer to Chapter 2 of this guide for more information about the PIP 
command. 


Action. Retype the command with a valid source. 
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ERROR: INVALID USER NUMBER 


Meaning. This message can be displayed if PIP finds an illegal user num- 
ber in the command. Legal user numbers are 0 to 15. 


Refer to Chapter 2 of this guide for more information about the PIP com- 
mand and user numbers. 


Action. Retype the command using a legal user number. 


ERROR: NO DIRECTORY SPACE - [drv:filename.typ] 

Meaning. This message can be displayed if PIP cannot write a file onto a 
diskette due to insufficient directory space. Diskette directories can hold 
128 file names, PIP usually displays this message if the diskette contains 
many small files. 


Refer to Chapter 2 of this guide for more information about the PIP 
command, 


Action. Insert another diskette with free space on it or erase unnecessary 
files from the diskette. Then, retype the command. 


ERROR: QUIT NOT FOUND 


Meaning. This message can be displayed if PIP cannot find the specified 
“quit” string in the source file while using the [Q] parameter. 


Refer to Chapter 2 of this guide for more information about the PIP 
command. 


Action. Retype the command using a valid string. 
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ERROR: START NOT FOUND 


Meaning. This message can be displayed if PIP cannot find the specified 
“start” string in the source file while using the [S] parameter. 


Refer to Chapter 2 of this guide for more information about the PIP 
command. 


Action. Retype the:command using a valid string. 


ERROR: UNEXPECTED END OF HEX FILE - [drv:filename.typ] 
Meaning. This message can be displayed if PIP finds an end-of-file 
marker before the hexadecimal record is ended while using the 

[H] parameter, An end-of-file marker is a code inserted into a hexadecimal 
file that indicates where a hexadecimal record ends. 


Refer to Chapter 2 of this guide for more information about the PIP 
command, 


Action. Repeat the procedure that generated the hexadecimal file and 
retype the command. 


ERROR: USER ABORTED 
Meaning. This message can be displayed if you stop a PIP command. 


Refer to Chapter 2 of this guide for more information about the PIP 
command, 


Action. Retype the command. 
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ERROR: VERIFY - [drv:filename.typ] 

Meaning. This message can be displayed if PIP finds a difference 
between the source and destination files while using the [V] parameter. 
Usually this indicates a destination diskette failure. 


Refer to Chapter 2 of this guide for more information about the PIP 
command. 


Action. Insert another destination diskette, and retype the command. 


Error On Line nnn Diskette Write Error 


Meaning. This message can be displayed if SUBMIT cannot create a 
temporary $$$.SUB file on the diskette that the operating system was 
started from. This message usually is displayed if you have a full diskette, 
or if the operating system diskette has a write-protect tab on the write- 
protect notch. 


Refer to Chapter 2 of this guide for more information about the SUBMIT 
command, 


Action. Insert another diskette with free space on it or erase unnecessary 
files from the full diskette, and retype the command. 


Error On Line nnn Parameter Error 

Meaning. This message can be displayed if SUBMIT finds invalid place 
holders in the .SUB file. For example, you may have typed 1$ rather than 
$1 in the .SUB file. 


Refer to Chapter 2 of this guide for more information about the SUBMIT 
command, 


Action. Edit the .SUB file, correct the problem, and retype the command. 
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Error On Line nnn No "'SUB' File Present 


Meaning. This message can be displayed if SUBMIT cannot find the 
specified .SUB file. That is, if; 


* The file name is mistyped. 
e The file type is other than .SUB. 


Refer to Chapter 2 of this guide for more information about the SUBMIT 
command, 


Action. 


*® Retype the command with the correct file name. 


* Create a file with a .SUB file type, insert the desired commands, and 
retype the command, 


FATAL ERROR 
Hard disk does not respond 


Meaning. This message can occur if the hard disk did not indicate that it 
had completed a procedure. 


Action. Return to the Main Screen and try to run the diagnostic test 
(Option 4). 


FATAL ERROR 
Hardware failure detected during testing 


Meaning. This message can occur during the initialization procedure of 
your hard disk when either the disk controller board or the drive has faulty 
hardware. 


Refer to the Rainbow Winchester Disk Option Installation Guide for more 
information about installing the hard disk. 


Action. Return to the Main Screen and run the diagnostic test (Option 4). 
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FATAL ERROR 
Initialization data could not be read from hard disk 


Meaning. This message can occur while using the hard disk if the utility 
program cannot read back some of the data that it previously wrote onto 


the hard disk. 


Refer to Chapter 6 of this guide for more information about the hard disk 
utility program. 


Action. Return to the Main Screen and try to run the diagnostic test 
(Option 4). 


FATAL ERROR 
Initialization data could not be written on hard disk 


Meaning. This message can occur while using the hard disk if the utility 
program was not able to write some of the data that the operating system 
needs to read at a later time. 


Refer to Chapter 6 of this guide for more information about the hard disk 
utility program. 


Action. Return to the Main Screen and try to run the diagnostic test 
(Option 4). 


FATAL ERROR 
No hard disk diagnostic program 


Meaning. This message can occur when the file DEX16UTL.CMD is not 
found on the utility diskette provided with the hard disk. 


Refer to Chapter 6 of this guide for more information about the utility 
diskette. 


Action. Make a new copy of the utility diskette from the master copy. 
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FATAL ERROR 
No pre-boot program 


Meaning. This message is rare, but can occur if the file containing the 
pre-boot program could not be found on the utility diskette. 


Action. Using DISKCOPY, make a new copy of the diskette from the 
master utility diskette. 


FATAL ERROR 
No secondary boot program 


Meaning. This message is rare, but can occur if the file containing the 
secondary boot program could not be found on the utility diskette. 


Action. Using DISKCOPY, make a new copy of the master utility diskette. 


FATAL ERROR 
Programming error occurred 


Meaning. This message is very rare but can occur if the hard disk utility 
program detects a problem with the program code. 


Action. If this message is displayed, report the problem to the DIGITAL 
Customer Help Line. For the phone number of the office nearest you, look 
on the bottom of your keyboard or refer to Appendix C of this guide. 


FATAL ERROR 
Secondary boot program is too big 


Meaning. This message is rare, but can occur if the secondary boot pro- 
gram does not fit into the allocated space on the hard disk. This can only 
occur if the file was somehow overwritten or changed. 


Action. Using DISKCOPY, make a new copy of the diskette from the 
master utility diskette. 
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FILE EXISTS 


Meaning. This message can be displayed if you try to create or rename a 
file with a name that already exists. 


Refer to Chapter 2 of this guide for more information about file names. 


Action. Use another file name. 


File Not Found 


Meaning. This message can be displayed by STAT if: 


The specified file is not found on the specified diskette. 

The file name or file type is mistyped. 

The period between the file name and the file type is omitted. 
The wrong drive is specified. 

The file type is omitted. 

Too few wildcards are used. 


Refer to Chapter 2 of this guide for more information about the STAT 
command. 


Action. 


Insert the diskette containing the file. 

Retype the command including the correct file name and file type. 
Retype the command including the period between the file name and 
file type. 

Specify the correct drive. 

Retype the command including the file type. 

Retype the command including enough wildcards. 
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Hard disk option is not connected 


Meaning. This message can occur if the utility program did not find the 
hard disk controller board, 


Refer to the Rainbow Winchester Disk Option Installation Guide for more | 
information about the hard disk controller board. 


Action. Recheck the connections of the controller board, and try the pro- 
cedure again. 


Invalid Assignment 

Meaning. This message can be displayed if STAT finds an invalid physi- 
cal-to-logical device assignment in the command. This message usually is 
displayed because: 


¢ The physical or logical name is mistyped or is invalid. 
* The equal sign is omitted from the command. 


Refer to Chapter 2 of this guide for more information about the STAT 
command, 


Action. 


* Retype the command with valid physical and logical names. 


e¢ Retype the command including an equal sign. 


The command STAT VAL: displays valid assignments. 


Invalid Assignment 
Use: STAT drv:=RO 


Meaning. This message can be displayed by STAT if: 


® An invalid attribute is assigned to a drive. 
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© The attribute is omitted from the command when assigning a drive an 
attribute. 


Refer to Chapter 2 of this guide for more information about the STAT 
command, 


Action. 


© Retype the command including a valid drive attribute. 
* Retype the command including an attribute. 


Invalid Assignment 
Use: STAT drv:filename.typ [size] [ro] [rw] [sys] or [dir] 


Meaning. This message can be displayed if STAT finds an invalid attri- 
bute in the command. This message usually is displayed if: 


® The colon is omitted from a physical or logical device name. 
* The drive name is omitted. 
© The attribute is mistyped. 


¢ An invalid attribute separator is included. 


Refer to Chapter 2 of this guide for more information about the STAT 
command. 


Action. 


* Retype the command including the colon as part of the physical or 
logical device name. 


© Retype the command including a drive name. 
* Retype the command including a valid attribute. 


® Retype the command including a valid attribute separator. 
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MEMORY NOT AVAILABLE 
Meaning. The operating system displays this message if: 


* There is not enough memory to run the program or load the data you 
want to use. 


¢ Memory is not cleared from the previous program. 
Action. 


* Check the size of the program to make sure it fits into memory by 
referring to the program's documentation. 


* Type: 
(oni) 
to clear memory, 


Then, retry the procedure. 


nn? 


Meaning. This message can be displayed if you specify a user number 
less than 0 or greater than 15 in a USER command line. 


Refer to Chapter 2 of this guide for more information about the USER 
command, 


Action. Retype the command using a valid user number. 
NO FILE 


Meaning. This message can be displayed by DIR if: 


¢ The file is not found on the specified diskette. 
* The file name or file type is mistyped. 
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* The period between the file name and the file type is omitted, 
* The wrong drive is specified. 
° The file type is omitted. 


® Too few wildcards are used. 


Refer to Chapter 2 of this guide for more information about the DIR 
command. 


Action. 


® Retype the command after inserting the diskette containing the file. 
¢ Retype the command including the correct file name and file type. 


e Retype the command including the period between the file name and 
file type. 


® Retype the command including the correct drive. 
« Retype the command including the file type. 
e Retype the command including enough wildcards. 


NON-SYSTEM FILE(S) EXIST 


Meaning. This message can be displayed if you type DIRS and files with 
the Directory Attribute exist on the diskette for the current user number. 


Refer to Chapter 2 of this guide for more information about the DIRS 
command, 


Action. No action is required; this is an informative message only indicat- 
ing that the diskette contains files with the Directory Attribute. 


READ ERROR 


Meaning. This message can be displayed if TYPE cannot read the speci- 
fied file. 


Refer to Chapter 2 of this guide for more information about the TYPE 
command, 
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Action. Use STAT to check the status of the file; you may need to 
change the attribute. Then retype the command. Refer to Chapter 2 of this 
guide for more information about the TYPE and STAT commands, 


Read error on drive drv:, track nn, sector nn 

Type a number followed by Return: 

1. Retry operation. 

2. Cancel program execution. 

3. Ignore error. 

4, Proceed, returning error. 
==> 


Meaning. This message can be displayed if: 


* The operating system cannot read a diskette. 
* You have inserted a diskette with a format other than Rainbow. 


Action. Select one of the options by typing a number and pressing the 
Return key, 


1. If you choose to retry the procedure, the operating system repeats the 
failed disk operation. If the conditions causing the message have 
cleared up, the operating system continues as though no message had 
occurred, If the conditions causing the message still exist, the message 
will be repeated. 


2. If you choose to cancel the program, the operating system stops the 
current command or program process and returns you to the system 
prompt. If the operating system was in the process of writing files on 
the diskette when the message occurred, the files may be incomplete. 


3. If you choose to ignore the error, the operating system continues with 
the command or program as if no error had occurred. Any data read 
or written after this will probably be incorrect and you should check 
the files when done. 
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4, If you choose to proceed, returning the error, the operating system 
returns the error condition to the command or program. The program 
in turn discontinues processing and the result is identical to option 2, 
Some applications may provide additional actions or messages. 


If you return to the operating system: 


1. Replace the diskette. 
2. Retry the operation. 


READ ERROR. Try another? (Y/N) 


Meaning. This message can be displayed if DISKCOPY cannot read the 
source diskette, 


Refer to Chapter 2 of this guide for more information about the DISKCOPY 
command, 


Action. Insert a new source diskette. Then press the Y key to retry the 
procedure. 


If you want to exit the program, press the N key and then the Exit key, 


READ ERROR - UNABLE TO READ ALL DISK 
SECTORS 


Meaning. This message can occur while you are formatting the 
Winchester disk if the utility program was not able to read back one of the 
sectors just created. Refer to Chapter 6 of this guide for more information 
about formatting a hard disk. 


Action. Try the FORMAT procedure again. If the message persists, the 
disk is probably faulty and should be replaced by: 


° Reporting the problem to your vendor, 

* Reporting the problem to the DIGITAL Customer Help Line. For the 
phone number of the office nearest you, look on the bottom of your 
keyboard or refer to Appendix C of this guide. 
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® Ordering the part and installing it yourself if you have the Rainbow 
100 User’s Service Guide. This guide is not included in the Rainbow 
System Kit. 


RED ERROR: Bad syntax on line 
Try RED NEWNAME [=] [OLDNAME] [/W] 


Meaning. This message can be displayed while using RED if, for exam- 
ple, you include an extra character on the command line such as two equal 
signs. The second portion of the message is a reminder of the correct way 
to type the line. 

Refer to Chapter 3 of this guide for more information about RED. 


Action. Retype the line. 


RED ERROR: Cannot edit read-only file 

Meaning. This message can be displayed while using RED if the file you 
want to edit, or the diskette drive on which the file resides has been set to 
read only. 


Refer to Chapter 3 of this guide for more information about RED. 


Action, Reset the attribute of the file or diskette drive. 


RED ERROR: Illegal character on line, 
do not use ,<>;?[]* 


Meaning. This message can be displayed while using RED if you include 
any of the listed characters on the same line as the RED command, 


Refer to Chapter 3 of this guide for more information about RED. 


Action. Retype the line. 
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RED ERROR: Please enter ‘‘RED" followed by a file name 


Meaning. This message can be displayed while using RED if you omitted 
a file name after the command, RED. 


Refer to Chapter 3 of this guide for more information about RED. 


Action. Retype the command including the file name. 


Rename Error: File ‘‘filename.ext" already exists 
press any key to continue 


Meaning. This message can be displayed if MAINT tries to rename a file 
to an existing file name. 


Refer to Chapters 1 and 2 of this guide for more information about the 
MAINT command, 


Action. Press any key to implement the other changes you marked on the 
MAINT directory. Then, rename the file with another name. 


Seek error on drive drv:, track nn 
Type a number followed by Return: 
1. Retry operation. 
2. Cancel program execution. 
3. Ignore error. 
4, Proceed, returning error. 

==> 


Meaning. This message can occur if: 


* The operating system could not read the diskette. 
* You have inserted a diskette with a format other than Rainbow, 
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Action. Select one of the options by typing a number and pressing the 
return key. 


1. 


If you choose to retry the procedure, the operating system repeats the 
failed disk operation. If the conditions causing the message have 
cleared up, the operating system continues as though no message had 
occurred, If the conditions causing the message still exist, the message 
will be repeated. 


If you choose to'cancel the program, the operating system stops the 
current command or program process and returns you to the system 
prompt. If the operating system was in the process of writing files on 
the diskette when the message occurred, the files may be incomplete. 


If you choose to ignore the error, the operating system continues with 
the command or program as if no error had occurred. Any data read 
or written after this will probably be incorrect and you should check 
the files when done. 


If you choose to proceed, returning the error, the operating system 
returns the error condition to the command or program. The program 
in turn discontinues processing and the result is identical to option 2. 
Some applications may provide additional actions or messages. 


If you return to the operating system, try to reformat the diskette using 
FORMAT. Beware of the fact that all current data on the diskette will be 


lost. 


If the problem persists, refer to the Rainbow 100 User’s Service Guide 
to ensure that the drive cables are installed properly. If the problem still 
persists: 


292 


Report the problem to your vendor. 

Report the problem to the DIGITAL Customer Help Line. For the 
phone number of the office nearest you, look on the bottom of your 
keyboard or refer to Appendix C of this guide. 
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SORRY CANNOT OPEN DOCUMENT 

Meaning. This message can be displayed if RED cannot write a file onto 
a diskette due to insufficient directory space. Diskette directories can hold 
128 file names, RED usually displays this message if the diskette contains 
many small files. 


Refer to Chapter 3 of this guide for more information about RED. 


Action. Insert another diskette with free space on it or erase unneeded 
files from the diskette, Then, recreate the document. 


SOURCE DISKETTE FORMAT IS INCORRECT 


Meaning. This message can occur if the DISKCOPY program cannot 
determine the type of diskette in the source drive. 


Refer to Chapter 2 of this guide for more information about the DISKCOPY 
command, 


Action. Replace the diskette in the source drive. 


SOURCE DISKETTE IS NOT RX50 FORMAT 


Meaning. This message can occur when using DISKCOPY if you have a 
diskette with the wrong format in the source drive. 


Refer to Chapter 2 of this guide for more information about the DISKCOPY 
command. 


Action. Replace the diskette with one that has the proper format, or for- 
mat the diskette currently in the drive. 


SYSTEM FILE(S) EXIST 


Meaning. This message can be displayed if you type DIR and files with 
the System Attribute exist on the diskette for the current user number. 
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Refer to Chapter 2 of this guide for more information about the DIR 
command, 


Action. No action is required; this is an informative message only, indicat- 
ing that the diskette contains files with the System Attribute. 


The file CPM.SYS not found on this disk 
Do a system reset with a new disk 


Meaning. This message can be displayed if the operating system cannot 
find the file CPM.SYS on the diskette. This file must be stored on the 
system diskette to start the operating system, 


Action. 


1, Reset the computer by pressing the Set-Up key and then typing 
Ctrl/Set-Up. 


Insert a system diskette with the file CPM,SYS on it, 

Restart the operating system. 
The file Z8OCNF.SYS cannot be loaded 
Meaning. This message can be displayed if the operating system cannot 
load the file Z30CNF.SYS into memory; this file must be loaded to run 
CP/M-80 programs. The reason is possibly due to a bad copy of 
Z80CNF.SYS 
Action. 

° Type: 
Cou) 


to reinitialize the operating system. 
* Retry the procedure. 
© Try a different diskette with Z830CNF.SYS on it. 
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The file Z8OCNF.SYS cannot be found 
on the System Disk 


Meaning. This message can be displayed if the operating system cannot 
find the file Z30CNF.SYS on the system diskette. This file must be stored 
on the system diskette to run CP/M-80 programs. 
Action. 

1. Insert a system diskette with the file Z80CNF.SYS stored on it. 

2. Retry the procedure. 
The start of partition drv: was moved 
Meaning. This message can occur while using the utility to partition the 
hard disk if one or more bad sectors are found on the first two tracks of 
the partition. The start of the partition is moved to a location where two 


consecutive problem-free tracks are found. 


Refer to Chapter 6 of this guide for more information about the partition 
utility for the hard disk, 


Action. Press the Resume key. The partition is still usable, but is slightly 
smaller. 


Topic not found 


Meaning. This message can be displayed if HELP finds no information on 
the requested topic. 


Refer to Chapter 2 of this guide for more information about the HELP 
command. 


Action. Select a topic from the Help Menu, 
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WARNING: Files may not be intact on drive drv: 


Meaning. This message can occur when you turn on the computer, or 
start the operating system, if you have a hard disk. It indicates that there 
may be a problem with the files on the disk. 


Action, Make a back-up copy of the files on the disk. Then re-run the 
utility program to initialize the hard disk, or reformat the partitions on the 
disk. Refer to Chapter 6 of this guide for more information about backing 


up files and reformatting partitions, Refer to the Rainbow Winchester Disk 
Option Installation Guide for more information about installing the disk. 


WARNING: The hard disk is not formatted or 
not partitioned 


Meaning. This message occurs if: 


* The hard disk has not been installed properly. 


© The hard disk has been installed properly, and the diagnostic test has 
been run successfully, but something has happened to the disk. 


The situation is not fatal, but the files on your hard disk may contain lost or 
garbled data. 


Action. Rerun the diagnostic test and the initialization procedure. 
If the problem persists: 


® Call your vendor 
* Call the DIGITAL Customer Help Line 


Refer to Chapter 6 of this guide for more information about running the 
diagnostic test. 
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WRITE ERROR: CANNOT FORMAT DISKETTE 
Meaning. This message indicates that the diskette is write-protected. 


Action. Remove the write-protect tab and restart the procedure, 


Write error on drive drv:, track nn, sector nn 
Type a number followed by Return: 

1. Retry operation. 

2. Cancel program execution. 

3. Ignore error. 

4. Proceed, returning error. 


> 


Meaning. This message can be displayed if the operating system cannot 
write onto a diskette. 


Action. 


1. If you choose to retry the procedure, the operating system repeats the 
failed disk operation. If the conditions causing the message have 
cleared up, the operating system continues as though no message had 
occurred. If the conditions causing the message still exist, the message 
will be repeated. 


2. If you choose to cancel the program, the operating system stops the 
current command or program process and returns you to the system 
prompt. If the operating system was in the process of writing files on 
the diskette when the message occurred, the files may be incomplete. 


3. If you choose to ignore the error, the operating system continues with 
the command or program as if no error had occurred, Any data read 
or written after this will probably be incorrect and you should check 
the files when done. 


4, If you choose to proceed, returning the error, the operating system 
returns the error condition to the command or program. The program 
in turn discontinues processing and the result is identical to option 2. 
Some applications may provide additional actions or messages. 


297 


Operating System Messages 


WRITE ERROR. Try another? (Y/N) 


Meaning. This message can be displayed if DISKCOPY cannot write onto 
the destination diskette. 


Refer to Chapter 2 of this guide for more information about the DISKCOPY 
command. . 


Action. Insert a new destination diskette. Then, press the Y key to retry 
the procedure. 


Tf you want to exit the program, press the N key and then the Exit key. 
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Country 


USA. 

Canada 

United Kingdom 
Belgium 

West Germany 
Italy 

Japan 
Denmark 
Spain 

Finland 
Holland 
Switzerland 
Sweden 
Norway 

France 

Austria 


Australia Sydney 
All other areas 


Cc 


Getting Help 


Phone Number 


(800) DEC-8000 

(800) 267-5251 

(0256) 59 200 

(02)-24 26 790 

(089) 95 91 66 44 

(02)-617 53 81 or 617 53 82 
(0424) 64-3302 

(04)-30 10 05 

(1)-73 34 307 

(90)-42 33 32 

(1820)-31 100 

(01)-810 51 21 

(08)-98 88 35 

(02)-25 64 22 

(1)-687 31 52 

(222)-67 76 41 extension 444 


(02) 412-5555 
(008) 226377 
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Active drive 40 
Additional Options key 24 
Addtnl Options key 
MAINT 81, 85, 87 
Advanced commands 
RED 160 
Ambiguous file names 42 
Append command 
RED 128, 167-169 
Appending two documents 
RED 169 
Application program 249 
starting 195 
ASM command 55 
ASM86 command 55 
Attributes 48, 56 
changing file 84 
Directory 48, 109 
drive 50 
file 48 


Index 


Read Only 48-50, 109 
Read Write 48-50, 109, 115 
System 48-49, 109 


Backing up files 199 

Backspace key 37 

BACKUP command 199-200, 202 
form 199 

Backup diskettes 224 

BACKUP program 
Main Screen 201-202 

Blank diskette 132 

Brackets 56 

Byte 79, 206, 252 
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Cancel key 27 
MAINT 83-84, 86, 88-89 
Carriage return symbol 
RED 146, 148, 159 
Changing a document 142 
Column width 
RED 185 
Command 5, 36 
canceling 27 
correcting 10 
Ctrl/C 31, 189, 193-195, 249 
DIR 7, 157, 167, 181, 191 
DIRS 192 
HELP 29 
MAINT 20 
erasing 26 
exiting 27 
renaming 24 
MDRIVE 90, 
mistyping 10 
PIP 18-19, 193, 197 
Quit 16 
RED 13 
RED Insert 15 
SUBMIT 191, 198 
typing 7 
Command conventions 56 
Command file 118 
Command keyword 36 
Command line 36 
Command PIP 198 
Command tail 36 
Commands 
ASM 55, 
ASM86 55 
BACKUP 199-200, 202 
built-in 52 
carriage return 36 
DATE 54, 57, 200, 225 
DDT 55 
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DDT86 55 
DIR 48, 54, 59, 67 
DIRS 49, 54, 61 
DISKCOPY 54, 63 
form 63 
DUMP 55 
ED 55 
ERA 54, 62, 68 
FORMAT 54, 70 
GENCMD 55 
HELP 54, 73 
LDCOPY 55 
LMCMD 55 
LOAD 55 
MAINT 48-49, 54, 76, 99 
purpose 76 
renaming 82 
MDRIVE 54 
PIP 54, 94 
RED 54, 105, 128-129 
REN 54, 106 
SAVE 55 
STAT 48-49, 51, 54, 99, 108 
SUBMIT 54, 118, 208 
transient 52 
TYPE 54, 123 
instructions 123 
USER 54, 125 
using 36 
Console 114 
Copy command 
RED 128, 175, 177 
Copying data from other diskettes 196 
Copying operating system files 188 
Copying text 
RED 175 
Correcting mistakes 
MAINT 86 
CP/M-86/80 operating system 1 
CP/M-86/80 start-up message 4 
Creating a document 13, 132, 136 


Index 


Creating a system/application diskette 
188 
Ctrl key 38 
Ctrl/C 39, 262 
PIP 96 
Ctrl/C command 189, 193-195, 249 
Ctrl/C key 
MAINT 81, 86 
STAT 115 
TYPE 124 
Ctrl/H 39 
Ctri/l 39 
Ctrl/J 39 
Ctrl/M 39 
Ctrl/P 39 
Ctrl/Q 39 
Ctrl/R 39 
Ctrl/S 39 
Ctri/S key 
TYPE 124 
Ctrl/U 39 
Ctrl/X 39, 262 
Ctr/Z 39 
PIP 97 
Cursor 7 
arrow keys 142 
blinking 151 
control keys in MAINT 80 
direction 142, 163 
moving 23, 142, 160 
moving in MAINT 80 
punctuation keys 142 
RED 135, 137, 141, 148, 151 
Return key 142 
reversing the 147 
space bar key 142 
Tab key 142 
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Data diskette 188 
Data surface of diskette 249 
DATE command 54, 57, 200, 225 
examples 58 
form 57 
DDT command 55 
DDT86 command 55 
Delete character key 11-12, 16, 37 
RED 131 
Destination diskette 63-65 
Devices 56 
logical 56, 112 
logical name assignments 114 
physical 56, 112 
physical name assignments 114 
status 112 
DIR command 7, 48, 54, 59, 67, 157, 
167, 181, 191 
examples 60 
form 59, 61 
Directional arrow keys 23, 196 
MAINT 81 
RED 131 
Directory 7, 19 
MAINT 79 
system 8, 54 
Directory attribute 48, 109 
DIRS command 49, 54, 61, 192 
DISKCOPY command 54, 63 
example 65 
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Diskette 
back-up procedures 249 
blank 132 
care of 247 
copying 249 
creating a system/application 188 
data 188 
data surface 249 
destination 63-65 
handling 248 
hard disk utility 209, 214, 216, 241 
label 194 
labels 249 
master 249 
master system 49 
protecting 252 
sectors 250-252 
source 63 
storing 248 
storing information 45-46, 250 
system/application 188, 194 
tracks 250-252 
using 249 
working 5, 188 
write-protect notch 252 
write-protect tab 252 
Display command 
RED 128, 141 
Displaying a file 
MAINT 85 
Do key 16, 25-26 
MAINT 77, 81, 83-84, 88-89 
RED 131, 137, 144 
Document 
copying to another diskette 19 
creating 13 
printing 13, 18 
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Drive 
active 5, 40 
characteristics 48 
default 5 
name 40, 56 
specifier 40 
specifying a different 19 
Drive name 132 
DUMP command 55 


E 


ED command 55 

Editing a file 127 

Editor 13 
file names 132 
RED 127-128 
starting 13, 132 

ERA command 54, 62, 68 
examples 69 
form 68 

Erase command 

ED 128, 145 

ing a file 26 
MAINT 84 

Erasing text 
RED 145, 147, 182 

Exchanging characters 
RED 148 

Exit key 24, 27, 64, 70 
MAINT 78, 81, 85-87 
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File 5 
ambiguous names 42 
attributes 48 
characteristics 48 
creating 132 
displaying with MAINT 85 
editing 127 
erasing 26 
erasing with MAINT 84 
extension 40 
name 40-41, 56, 83 
program 5 
references 42 
renaming 25, 83 
specification 40, 56 
text 5 
type 40-41, 56 
unambiguous names 42 
viewing 24 
File control block 79, 109 
File name 8, 13, 180 
File type 8, 13 
Files 
backing up 199 
backing up hard disk 222 
comparing hard disk and diskette 237 
copying from hard disk 223 
data 5 
indirect 229 
listing hard disk names 238 
naming 41 
performing maintenance 20 
program 5 
restoring 199, 202 
restoring hard disk 222, 232 
status 109 
using 40 
Find key 23 
MAINT 81 
RED 131, 163 
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FORMAT command 54, 70 
example 71 
form 70 
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Genemd command 55 
Goto command 
RED 128, 161-162, 172, 174 
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Hard disk 

(Winchester disk) 206, 209 

advanced procedures 205 

alternate sectors 242 

auto-boot partition menu 211 

backing up files 222 

BACKUP program 222-224, 228, 
233, 235, 238-239 

changing date and time 227 

changing default partitions 213 

changing partitions 216 

choice of operating systems 218 

comparing files 237 

copying files to diskettes 223 

CP/M-86/80 partition menu 219 

default partitions 213, 215-216 

detecting problems 241 

diagnostic test 242 

directory options 239 

example of re-partitioned disk 221 

Help key 223 

installation 207 

listing file names 238 

MS-DOS partition menu 220 

partitioning 215 

problem sectors 242, 244 

RECOVER program 241 

recovering from problems 241 

restoring files 222, 232 

sectors 241 


305 


Index 


standard backup options 224 
standard restore options 233 
standard verify options 237 


starting operating system from 208, 


212 
storage capacity 206 


utility diskette 209, 214, 216, 241 


utility program Main Screen 209, 
214, 216 P 
Hard disk BACKUP program 
advanced backup procedures 227 
advanced restore options 234 
backing up files 225 
leaving 240 
Main Screen 223 
short cut 240 
HELP command 29, 54, 73 
form 73 
RED 129, 154-155 
HELP command EXAMPLES 75 
Help key 27, 29, 201 
MAINT 78, 81, 86 
RED 131, 154 
Hold Screen key 
TYPE 124 
Hold screen key 38 


Insert command 
RED 129, 136, 144 
Insert Here key 
RED 131, 136 
Inserting text 
RED 15, 137 
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K 
Key 


Additional Options 24 
backspace 37 
Cancel 27 
Ctrl 38 
Delete character 11-12, 16, 37 
Do 16, 25-26 
Exit 24, 27, 64, 70 
Find 23 
Help 27, 29, 201 
Hold screen 38 
Line feed 37 
Remove 26 
Return 7, 10, 16, 23, 29, 37 
Select 23 
Set-Up 3, 32, 209 
Tab 23 
Keyboard control keys 39 
Ctrl/C 39 
Ctrl/H 39 
Ctrl/I 39 
Ctrl/J 39 
Ctrl/M 39 
Cturl/P 39 
Ctrl/Q 39 
Ctrl/R 39 
Ctrl/S 39 
Ctrl/U 39 
Ctrl/X 39 
Ctrl/Z 39 
Keys 
directional arrow 23, 196 
MAINT 22 
Kilobyte 79 
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LDCOPY command 55 
LDCOPY program 212 
Leaving RED 16 
Line feed key 37 
Listing document names 
RED 167 
Listing file names 7 
LMCMD command 55 
LOAD command 55 
LOADER.SYS program 212 
Locate command 
RED 129, 163 
Locating text 
RED 164 
Logical devices 112 
Looking at a document 
RED 141 


M 


Main System Menu 3 
MAINT 
correcting mistakes 86 
directory 22, 79 
leaving 27, 86 
moving the cursor 80 
running 78 
special function keys 22 
using 77 
MAINT command 20, 48-49, 54, 76, 
99 
examples 86 
form 77 


MAINT keys 
Addtnl Options 81, 85, 87 
Cancel 81, 83-84, 86, 88-89 
Ctri/C 81, 86 
cursor control 80 
directional arrow 81 
Do 77, 81, 83-84, 88-89 
Exit 78, 81, 85-87 
Find 81 
Help 78, 81, 86 
Next Screen 79, 81, 85, 87 
Prey Screen 79, 81, 85 
Remove 77, 81, 84, 89 
Return 81 
Select 81 
special function 77, 80 
Tab 81 

Marking text 
RED 146 

Master diskette 249 

Master system diskette 49 

MDRIVE command 54, 90 
examples 90. 
form 90 

Megabyte 206 

Message conventions 261 

Messages 18, 30, 189, 193, 

197-198 
RED 158 
system 30 

Move command 
RED 129, 170, 172, 174 

Moving text 
RED 170 
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N PIP command 18-19, 54, 94, 193, 
197-198 

command mode 94 

examples 101 

forms 94, 97 

parameters 56, 94-95, 97 


Next command 
RED 129, 134 
Next Screen key 
MAINT 79, 81, 85, 87 


RED 141 program mode 96 
prompt 96 
fo) Pointer command 
Copy 175-176 
Operating system 1 Move 170, 172 
commands 52 oi ‘ 
eC RED 129, 170 
CP/M-86/80 1, 3 Write 178 
messages 255 Zap 182 
prompt 5, 10, 27, 157 Pointers 
restarting 31 Copy 175-176 
ae Move 170, 172, 174 
uy . setting 176 
starting from hard disk 208, 212 aaah 
Output command 2 
doktor, Zap 182, 184 
RED 129, 159 Port 114 
Power switch 3 
P Prev Screen key 
eaters MAINT 79, 81, 85 
BPRS RED 131, 141 


Partitioning Printing a document 13, 18 


‘4 PIP 103 
és eos isk 215 RED 159 
‘artitions: Program 


changing 216 
default 216 
hard disk 213, 215 


application 188, 249 
Program file 5 


ue ae Prompt 5 
a devices 112 HELP 74 
PIP 96, 104 


printing a document 103 


151.15 
program mode 96 RED Ap To4 188 


Protective card 3 
Protective paper envelope 249 
Q 
Quit command 16 
RED 129, 156, 181 
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Rainbow computer 
resetting 31 
turning on 3 
Read Only attribute 48-50, 109 
Read Write attribute 48-50, 109, 115 
RECOVER program 
hard disk 241 
RED 
appending two documents 169 
blinking cursor 151 
Broken Line 135 
carriage return symbol 146, 148, 159 
character count 135 
command 132 
Command Line 134, 137, 144, 148, 
159, 163 
commands 128 
copying text 175 
cursor 135, 137, 141-142, 148, 
160, 162 
editor 127 
erasing text 147, 182 
exchanging characters 148 
file names 132 
header lines 133 
inserting text 137 
leaving 16 
line count 135 
listing document names 167 
locating text 164 
marking text 146 
messages 132, 158 
moving text 170 
moving the cursor 142 
printing a document 159 
Replace prompt 150-151, 153 
replacing text 149-150 
Status Line 135, 162, 164 
storing a new document 158 
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RED command 13, 54, 105 
examples 105 
form 105 

RED commands 129 
advanced 160 
Append 128, 167 
Append Insert 167, 169 
Append List 167-168 
column width 185 
Copy 128, 175, 177 
Display 128, 141 
Erase 128, 145 
Goto 128, 161-162, 172, 174 
HELP 129, 154-155 
Insert 129, 136, 144 
Locate 129, 163 
Move 129, 170, 172, 174 
Next 129, 134 
Output 129, 159 
Pointer 129, 170 
Quit 129, 156, 181 
Replace 129, 149 
Tab 129, 138 
View 129, 165, 181 
Write 129, 178, 180 
Xchng 129, 148 
Zap 129, 182, 184 

RED editor 127-128 

RED Insert command 15 
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RED keys 
backspace 136 
cursor arrow 142 
Delete character 131 
directional arrow 131 
Do 131, 137, 144 
editing 128, 131 
Find 131, 163 
Help 131, 154 
Insert Here 131, 136, 144 
Next Screen 131, 141 
Prey Screen 131, 141 
Remove 145 
Return 131, 137, 142 
space bar 142 
Tab 138-139, 142 
RED keys Remove 131 
Remove key 26 
MAINT 77, 81, 84, 89 
RED 131, 145 
REN command 54, 106 
examples 107 
form 106 
Renaming a file 24, 83 
Replace command 
RED 129, 149 
Replacing text 
RED 149-150 
Resetting the Rainbow computer 31 
Restoring files 199, 202 
Return key 7, 10, 16, 23, 29, 37 
MAINT 81 
PIP 96 
RED 131, 137 
Reverse video 26 
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SAVE command 55 
Sectors 241 
alternate 242 
problem 242, 244 — 
Select key 23 
MAINT 81 
Set-Up key 3, 32, 209 
Setting date and time 225 
Source diskette 63 
Start-up message 5 
Starting application program 195 
Starting the operating system 3, 5 
STAT command 48-49, 51, 54, 99, 108 
examples 110, 116 
forms 108-109, 115 
Status of files 109 
Storing a new document 
RED 158 
Storing diskettes 248 
Storing information on a diskette 45-47 
Storing information on diskette 250 
SUBMIT command 54, 118, 191, 198, 
208 
command tail 119-120, 122 
examples 121 
forms 118 
place holders 119, 122 
SYSCOPY program 208 
System attribute 48-49, 109 
System directory 49, 54 
System messages 30, 255, 262 
System/application diskette 188, 194 
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Tab command 
RED 129, 138 
Tab key 23 
MAINT 81 
RED 138-139 
Technical Documentation Kit 35 
Text file 5 
Tracks 65 
Turning on the Rainbow computer 3 
TYPE command 54, 123 
examples 124 
form 123 
Hold Screen key 124 
Typing a command 7 
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Unambiguous file names 42 
USER command 54, 125 
examples 126 
forms 125 
User numbers 125-126 
Using commands 36 


Vv 


View command 
RED 129, 165, 181 
Viewing another document 
RED 165 
V1T180 computer 188 


w 


Wildcards 42, 59, 168, 229 
#45. 
243 
PIP 102 
Working diskette 5, 188 
Write command 
RED 129, 178, 180 
Write-protect notch 252 
Write-protect tab 50-51, 64, 68, 119, 
188, 252 
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Xchng command 
RED 129, 148 
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Zap command 
RED 129, 182, 184 
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Rainbow CP/M-86/80 User's 
Guide Additions 


Corrections to ‘Starting the Operating 
System from the Hard Disk’’ 


1. On page 208 of. Chapter 6, item #4 instructs you to type: 
A>SUBMIT SYSCOPY A: drv: CRewm) 
The instruction should be to type: 
A>SUBMIT SYSCOPY A drv CRewm) 


2. On page 209, item #5 instructs you to “Supply the destination drive 
name. Type:”” 


devi CRetwm >) 
The instruction should be to type: 


dry Comm) 


You cannot use colons in these command lines. 


Program Compatibility 


The following table lists the applications available from Digital Equipment 
Corporation. Columns two and three indicate which programs are supported 
by the Winchester hard disk, and the amount of memory required to run 
them. 


Winchester Hard Disk 


Application Support Memory Required 
Autosort 86 Yes 256Kb 
Condor I No 256Kb 
Condor IIT No 256Kb 
Daisy Aids Yes 128Kb 
Elec Blackboard No 256Kb 
Fabs 86 Yes 256Kb 
TK! Solver 86 Yes 128Kb 
IMS Mailing Yes 128Kb 
List Manager Yes 128Kb 
MBASIC-86 Yes 128Kb 
MicroPlan-86 Yes 128Kb 
Money I No 128Kb 
Money II No 128Kb 
Multiplan-86 Yes 128Kb 
C Compiler Yes 256Kb 
SELECT-86 Yes 128Kb 
poly-XFR * Yes 128Kb 
Target Model Yes 128Kb 


* See separate addendum for this product 
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Winchester Hard Disk 


Application Support Memory Required 
dBASE II Yes 128Kb 
RM Cobol Yes 128Kb 
Peachtext Yes 128Kb 
Spelling Proofreader Yes 128Kb 
CBASIC-86 Yes 128Kb 
Pascal Yes 256Kb 


Reading IBM Diskettes 


In order to read files stored on IBM diskettes, you must have 8-sector or 
9-sector single-sided IBM diskettes. 


Operating System Messages 


The following messages are new since the Rainbow CP/M-86/80 User's 
Guide was printed. 


ERROR IN PARTITION drv: 
Insufficent number of alternate sectors 


Meaning. This message can occur while running the hard disk utility pro- 
gram if there were not enough alternate sectors available to assign to the 
bad sectors within the partition. 


Action. Press the Resume key to advance to other partitions; others are 
still usable. 
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FATAL ERROR 
Couldn't read status data from the hard disk 


Meaning. This message can occur while running the hard disk RECOVER 
program if the hard disk status data necessary to perform the recovery 
could not be read without errors. 


Action. No action can be taken, and the recovery cannot be done. You 
must use the disk without running RECOVER, or re-initialize the disk using 
the utility diskette that came in the same box as the Rainbow Winchester 
Disk Option Installation Guide, 


FATAL ERROR 
Couldn't write status data onto the hard disk 


Meaning. This message can occur while running the hard disk RECOVER 
program if the new status data with the recovery information could not be 
written onto the hard disk without errors. 


Action. No action can be taken, and the recovery cannot be done. You 
must use the disk without running RECOVER, or re-initialize the disk using 
the utility diskette that came in the same box as the Rainbow Winchester 
Disk Option Installation Guide. 


FATAL ERROR 
Hard disk is not partitioned 


Meaning. This message can occur while running the hard disk RECOVER 
program. The message indicates that either you have not run the utility 
program that automatically partitions the disk, or for some reason, the 
partitioning or re-partitioning process did not happen. 


Action. Use the hard disk utility diskette to re-initialize the hard disk. 


oO 


FATAL ERROR 
Insufficient memory for program data buffers 


Meaning. This message can occur while running the hard disk RECOVER 
program if the program did not have enough main memory to store the 
data needed for recovery. 


Action. Check whether or not you have 128K bytes of memory. If you do, 
call the DIGITAL Help Line phone number listed in the back of the User’s 
Guide; you should be able to run RECOVER. If you have less than 128K 
bytes of memory, you cannot run RECOVER. 


FATAL ERROR 
Couldn't re-initialize the hard disk parameters 


Meaning. This message can occur while running the hard disk RECOVER 
program if the program failed to notify the operating system that the 
recovery was complete. 


Action. Restart the operating system by pressing the Set-Up key followed 
by the Ctrl and Set-Up keys. 


Drive drv: is not a valid hard disk drive name 


Meaning. This message can occur while running the hard disk RECOVER 
program if the drive name you specified with the RECOVER command is 
not within the range of valid hard disk drive names. The valid names are 
from E: through L:. 


Action. Proceed to the Main Screen for a menu of valid, assigned hard 
disk drives. 
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Drive drv: is not available on the hard disk 


Meaning. This message can occur while running the hard disk RECOVER 
program if the drive name you specified with the RECOVER command is a 
valid har disk drive name ,but not one that you have. 


Action. Proceed to the Main Screen for a menu of valid, assigned hard 
disk drives. 


Insufficient memory available for .COM files 


Meaning. This message can occur while running a CP/M-80 application, 
When you run an application, you are adding bytes to the portion of the 
operating system that is always in memory (the built-in portion). This mes- 
sage occurs if that built-in portion of the operating system becomes too 
large: greater than 64K bytes of memory. 


Action. Refer to the documentation associated with the application you 
are running. 


Source and destination disks must be of the same type 


Meaning. This message can occur while running the LDCOPY or SUB- 
MIT programs to copy operating system files from hard disk to a diskette. 


Action. There is no action. This is an informative message to let you 
know that this procedure cannot be done. 
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Cannot find file: HBOOT.LDX on source diskette 
Try LDCOPY drv:HBOOT.LDX if you want to copy a loader 
to the hard disk 


Meaning. This message can occur while running the LDCOPY or SUB- 
MIT programs to copy operating system files from a diskette to the hard 
disk, and the file HBOOT.LDX cannot be found on the diskette, 


Action. Follow the instructions in the message and try running the 
LDCOPY program from a drive containing a diskette that has the LDCOPY 
program and the HBOOT.LDX program on it. 


Rainbow CP/M-86/80 Getting 
Started Additions 


Leaving the LEARN RAINBOW Course 


The screen below replaces the exit screen shown on page 54 of the 
Rainbow CP/M-86/80 Getting Started. 


re 


1. Remove the d! 
Drive A and Drive B. 


2. Replace the 
their protec 


3. Turn off the power by 
Pressing the power switch 
to the "0" position. 


leaving 
inbow 


» Remove the "Learn Rainbow" 1 
diskettes from both drives | 
and store them safely. ' 


2. Reset the computer by 
pressing Set-Up, then 
Ctri/Set-Up 


3. From this point, proceed 
as if you had just turned 
the computer o 
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Rainbow™ poly-XFR™ 
and poly-BSC /RJE™ 


Addendum 
September 1983 


This addendum provides the information needed 
to change the files on the diskettes labeled 
POLY-XFR CP/M COMMS and 
POLY-BSC/RJE respectively. 


©Digital Equipment Corporation 1983. 
All Rights Reserved. 
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Research Inc. 


Rainbow poly-XFR Addendum 


If you have either of the following products: 


e POLY-XFR CP/M COMMS 
® POLY-BSC/RJE 


follow the instructions below to use the program with Version 2 of the 
Rainbow CP/M-86/80 operating system. 


1, Make a copy of the diskette: 


Insert the Version 2.0 CP/M-86/80 diskette into drive A 
In response to the prompt, type: 


A>DISKCOPY CReum) 


Remove the CP/M-86/80 diskette from drive A and replace it with 
the appropriate diskette 


Insert a blank diskette into drive B and answer the questions that 
DISKCOPY asks you. 


When the DISKCOPY program finishes, you have a duplicate copy of 
the diskette, 


2, Remove the original diskette from drive A, and follow the instructions 
on the last DISKCOPY screen to insert the CP/M-86/80 diskette. 


NOTE 

Be sure you insert the working copy of the 
CP/M-86/80 diskette that contains the POLYPAT 
program. 


3. After you press the Exit key, the prompt is displayed. In response to 
the prompt, type: 


A>POLYPAT Cieum) 


Running this program makes changes to the following four files on the 
poly-XFR diskette: 


e TRM.CMD 
*® XFR.CMD 
* HST.CMD 
e SWITCH.CMD 


Running this program makes changes to the following program on the 
poly-BSC/RJE diskette: 


* RJE.CMD 


. After these changes have been made, these diskettes are no longer 
compatible with Version 1 of the CP/M-86/80 operating system. 


